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Preface 



The complete XENIX Reference is actually divided into nine parts and 
distributed as individual reference sections in the various volumes of the 
XENIX Operating, Text Processing, and Development Systems. The 
following table lists the name, content, and location of each reference 
section. 



Section 



Description 



XENIX Volume 



ADM 



CP 



CT 



DOS 



HW 



M 



Administrative Commands 
for system administration. 



used System Administrator's Guide 



Commands - used with the XENIX 
Operating System. 

Programming Commands - used 
with the Development System. 

Text Processing Commands - used 
with the Text Processing System. 



Routines - used with 
Development System 



File Formats - description of 
various system files not defined in 
section M. 

Hardware specific manual pages - 
information about XENIX 
procedures specific to your 
computer. 

Miscellaneous - information used 
for access to devices, system 
maintenance, and communi- 
cations. 



User's Reference 



Programmer's Reference 



Text Processing Guide 



the Programmer's Reference 



User's Reference 



System Administrator's Guide 



User's Reference 



System Calls and Library 
Routines - available for C and 
assembly language programming. 



Programmer's Reference 



In the manual pages, a given command, routine, or file is referred to by 
name and section. For example, the programming command "cc", which 
is described in the Programming Commands (CP) section, is listed as 
cc (CP). 

The alphabetized table of contents given on the following pages is a 
complete listing of all XENIX commands, system calls, library routines, 
and file formats. The permuted index, found at the end of the XENIX 
User's Reference , and the the end of the XENIX Programmer's Reference , 
is useful in matching a desired task with the manual page that describes 
it. 



Alphabetized List 

Commands, Systems Calls, Library Routines and File Formats 



8087 8087(HW 

86rel 86rel(F 

a641 a64l(S 

a.out a.out(F 

abort abort(S 

abs abs(S 

accept accept (C 

access access (S 

acct acct(F 

acct acct(S 

acctcom acctcom (ADM 

accton accton (ADM 

acos trig(S 

adb adb(CF 

adfmt adfmt (ADM 

admin admin(CP 

alarm alarm(S 

aliases aliases (M 

aliases.hash aliases (M 

aliashash aliashash(ADM 

ar ar(CP 

ar ar(F 

archive archive (F 

ascii ascii(M 

asctime ctime (S 

asin trig(S 

asktime asktime (ADM 

assert assert (S 

assign assign(C 

asx as* (CP' 

at at(C 

atan trig(S 

atan2 trig(S 

atof atof(S 

atof strtod(S 

atol atof(S 

atol strtol(S 

autoboot autoboot (ADM 

awk awk(C 

backup backup (C 

backup backup (F 



badtrk badtrk(ADM) 

banner banner (C) 

basename basename(C) 

batch at(C) 

be bc(C) 

bdiff bdiff(C) 

bdos bdos(DOS) 

bessel bessel(S) 

bfs bfs(C) 

boot boot(HW) 

brk sbrk(S) 

brkctl brkctl(S) 

bsearch bsearch(S) 

cabs hypot(S) 

cal caliC) 

calendar calendar (C) 

calloc ,. mallociS) 

cancel lp(C) 

capinfo capinfo (C) 

cat cat(C) 

catimp catimp (CT) 

cb cb(CF) 

cc cc (CP) 

cd cd(C) 

ede cdc(CP) 

ceil floor (S) 

cflow c flow (CP) 

cgets cgets (DOS) 

character eqnchar(CT) 

charmap charmap(CT) 

chdir chdir(S) 

checkew cw (CT) 

checkeq eqn{CT) 

checklist checklist (F) 

checkmm checkmm (CT) 

chgrp chgrp(C) 

chmod chmod(C) 

chmod chmod(S) 

chown chown(C) 

chown chown(S) 

chroot chroot (ADM) 



chroot chroot(S) 

chsh chsh(ADM) 

chsize chsize (S) 

clear clear (C) 

clearerr f error (S) 

clock clock (F) 

clock clock (S) 

close close (S) 

clri clri (ADM) 

cmchk cmchk(C) 

cmos cmos (HW) 

cmp cmp(C) 

coffconv coffconv(M) 

col col (CT) 

comb comb (CP) 

comm comm(C) 

compress compress (C) 

config cot^(ADM) 

configure configure (ADM) 

console console (M) 

consoleprint. consoleprint (ADM) 

contains eqnchar (CT) 

conv conv (S) 

convkey mapkey (M) 

copy copy(C) 

core core (F) 

cos trig(S) 

cosh sinh(S) 

cp c/?(C) 

cpio cpio(C) 

cpio cp/o (F) 

cpp cpp (CP) 

cprintf cprintf(DOS) 

cputs cputs(DOS) 

creat creat(S) 

creatsem creatsem (S) 

cref cref '(CP) 

cron cron(C) 

cscanf cscanf(DOS) 

csh csh(C) 

csplit csplit(C) 

ct rt(C) 

ctags cfags(CP) 

ctermid ctermid(S) 

ctime ctime (S) 

ctype cfyp<?(S) 



cu cu (C) 

curses curses (S) 

cuserid cuserid(S) 

custom custom(ADM) 

cut cut (CT) 

cw cw(CT) 

cwcheck cw (CT) 

cxref cxr<?/(CP) 

daemon.mn daemon.mn(M) 

date date (C) 

dbminit dbm(S) 

dc rfc(C) 

dd dd(C) 

deassign assign (C) 

deco dec<? (CT) 

default default (F) 

definitions eqnchar (CT) 

defopen defopen (S) 

defread defopen (S) 

delete dbm(S) 

delta delta (CP) 

deroff deroff(CT) 

devnm devnm(C) 

df rf/(C) 

dial dial (ADM) 

dial dz'a/ (S) 

diction diction (CT) 

diff J#(C) 

difS d#?(C) 

difftnk dijfmk(CT) 

dir d/r(F) 

dircmp dircmp(C) 

dirname dirname(C) 

disable disable (C) 

diskcmp diskcp (C) 

diskcp diskcp (C) 

divvy divvy (ADM) 

dmesg dmesg (ADM) 

dos dos(C) 

doscat dos(C) 

doscp dos(C) 

dosdir doS(C) 

dosexterr dosexter (DOS) 

dosformat dos(C) 

dosld dosld(CP) 
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dosls dos(C 

dosmkdir dos(C 

dosrm dos(C 

dosrmdir dos(C 

dparam dparam(ADM 

drand48 drand48(S 

dtype dtype(C 

du du(C 

dump dump(C 

dump dump(F 

dumpdir dumpdiriC 

dup dup(S 

dup2 dup(S 

dviimp dviimp (CT 

echo echo(C 

ecvt ecvt(S 

ed ed(C 

edata end(S 

egrep grep(C 

enable enable (C 

enco deco (CT 

end end(S 

endgrent getgrent(S 

endpwent getpwent (S 

env env(C 

environ environ (M 

eof eof(DOS 

eqn eqn(CT 

eqn eqnchar (CT 

eqnchar eqnchar (CT 

eqncheck eqn(CT 

erand48 drand48(S 

erf erf(S 

erfc erf(S 

errno perror(S 

error error (M 

etext end(S 

ex ex(C 

execl exec (S 

execle exec (S 

execlp exec (S 

execseg execseg (S 

execv exec (S 

execve exec (S 

execvp exec (S 

exit exit (DOS 



_exit exz7(S) 

exp exp(S) 

explain explain (CT) 

expr expr(C) 

fabs floor (S) 

factor factor (C) 

faliases aliases (M) 

false false (C) 

fclose /c/0se(DOS) 

fclose fclose (S) 

fcloseall /c/ose (DOS) 

fcntl /c^/(S) 

fcvt ecvt(S) 

fd /d(HW) 

fdisk f disk (ADM) 

fdopen fopen(S) 

fdswap /dswa/?(ADM) 

feof f error (S) 

ferror J error (S) 

fetch dbm(S) 

fflush fclose (S) 

fgetc /ge?c(DOS) 

fgetc gefc (S) 

fgetchar fgetc (DOS) 

fgets gets (S) 

fgrep grep(C) 

file file(C) 

filelength fileleng(DOS) 

fileno ferror (S) 

filesys filesys (F) 

filesystem filesystem(F) 

find yznJ(C) 

finger finger (C) 

firstkey dbm(S) 

fixhdr fixhdr(C) 

fixpad capinfo (C) 

fixperm fixperm (ADM) 

floor floor (S) 

flushall flushall (DOS) 

fmod floor (S) 

fopen fopen(S) 

for eqnchar (CT) 

fork /orA;(S) 

format format (C) 

fp_off //?_seg(DOS) 

fprintf printf(S) 
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fp_seg fpseg (DOS 

fputc Jputc (DOS 

fputc putc(S 

fputchar fputc (DOS 

fputs puts(S 

fread fread(S 

free malloc (S 

f reopen .fopen(S 

frexp frexp(S 

fsave f save (ADM 

fscanf scanf(S 

fsck fsck(ADM 

fsdb fsdb (ADM. 

fseek fseek(S 

fsname fsname (ADM 

fsphoto fsphoto (ADM 

fstab fstab(F 

fstat statf(S 

ftell /j«?*(S. 

ftime time(S 

ftok stdipc(S 

ftw /m>(S 

fwrite fread(S 

fxlist xlist(S 

gamma gamma(S 

gcvt ecvt(S 

get #*(CF 

getc getc(S 

getch getch (DOS 

getchar getc (S 

getche getche (DOS 

getcwd getcwd(S 

getegid getuid(S 

getenv getenv(S 

geteuid getuid(S 

getgid getuid(S 

getgrent getgrent(S 

getgrgid getgrent (S 

getgrnam getgrent (S 

getlogin getlogin(S 

getopt getopt(C 

getopt getopt (S 

getpass getpass(S 

getpgrp getpid(S 

getpid getpid(S 

getppid getpid (S 



getpw getpw(S) 

getpwent getpwent (S) 

getpwnam getpwent (S) 

getpwuid getpwent (S) 

gets gets (CP) 

gets gets(S) 

getty getty(M) 

gettydefs gettydefs (F) 

getuid getuid(S) 

getutent getut(S) 

getutid getut(S) 

getutline getut(S) 

getw getc (S) 

gmtime ctime (S) 

grep grep(C) 

group group (F) 

grpcheck grpcheck(C) 

gsignal ssignal(S) 

haltsys haltsys (ADM) 

hashcheck spell (CT) 

hashmake spell (CT) 

hcreate hsearch(S) 

hd hd(C) 

hd hd(EW) 

hdestroy hsearch(S) 

hdr hdr(CP) 

head head(C) 

hello hello(C) 

help help(C) 

help help (CP) 

hsearch hsearch (S) 

hwconfig hwconfig(C) 

hyphen hyphen(CY) 

hypot hypot(S) 

id id(C) 

idleout idleout(ADM) 

imacct imacct(C) 

imagen imagen(M) 

imagen.pbs imagen (M) 

imagen.remote imagen(M) 

imagen.sbs imagen(M) 

imagen.spp imagen(M) 

imprint imprint (C) 

imprint imprint (CT) 

inir init(M) 

init init(M) 
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inittab inittab (F) 

inode inode (F) 

inp inp (DOS) 

install install (ADM) 

int86 int86 (DOS) 

int86x int86x(DOS) 

intdos intdos (DOS) 

intdosx intdosx(DOS) 

intro Intro (ADM) 

intro Intro (C) 

intro Intro (CP) 

intro Intro (CT) 

intro ; mfro (DOS) 

intro Intro (F) 

intro Intro(HW) 

intro Intro (M) 

intro Intro (S) 

ioctl ioctl(S) 

ipbs i>j(ADM) 

ipcrm /perm (ADM) 

ipes zpes (ADM) 

ipr *pKQ 

iprint iprint(C) 

ips /^(ADM) 

isalnum ctype (S) 

isalpha cfype (S) 

isascii ctype (S) 

isatty isatty (DOS) 

isatty ttyname (S) 

isbs /p5(ADM) 

iscntrl ctype (S) 

isdigit ctype (S) 

isgraph ctype (S) 

islower ctype (S) 

isprint ctype (S) 

ispunct ctype (S) 

isspace ctype (S) 

isupper ctype (S) 

isxdigit ctype (S) 

itoa zfoa(DOS) 

itroff itroff(CT) 

jO bessel(S) 

jl bessel(S) 

jn fosse/ (S) 

join join(C) 

jrand48 drand48(S) 



kbhit kbhit(DOS 

kbmode kbmode (ADM 

keyboard keyboard (HW 

kill kill(C 

kill fc7/(S; 

kmem mem(F 

1 l(C 

13tol /3to/(S 

164a a64l(S 

labs labs (DOS 

last last(C 

lc /c(C 

Id ld(M 

Id /d(CP 

ldexp frexp(S 

lex /ex(CP 

lflnd Isearch (S 

line line (C 

link link(S 

lint lint (CP 

In /n(C 

localtime crime (S 

lock lock(C 

lock /<?c£(S 

lockf /oc&f (S 

locking locking (S 

log exp(S 

loglO exp(S 

login login (M' 

logname logname(C 

logname logname (S 

longjmp setjmp (S 

look /<?0fc(CT 

lorder lorder(CP 

lp /p(C 

lp /p(HW 

lpO /p(HW 

lpl lp(HW 

lp2 lp(m?[ 

lpadmin lpadmin(ADM] 

lpinit Ipinit (ADM, 

lpmove Ipsched (ADM 

lpr //?(C 

lpr lpr(C 

Iprint Iprint (C 

Ipsched Ipsched (ADM, 



lpshut Ipsched (ADM 

lpstat IpstatiC 

Irand48 drand48(S 

Is ls(C 

lsearch Isearch (S 

lseek lseek(S 

Itoa ltoa(DOS 

Itol3 l3tol(S 

m4 m4(CP 

machine machine (HW 

mail mail(C 

make make (CP 

makekey makehey (ADJV1 

maliases aliases (M 

maliases.hash aliases (M 

mallinfo malloc (S 

malloc malloc (S 

mallopt malloc (S 

man man(CT 

mapchan mapchan(F 

mapchan mapchan(M 

mapkey mapkey (M. 

mapscrn mapkey (M 

mapstr mapkey (IVf 

masm masmiCP 

master master (F 

matherr matherr(S 

mem mem(F 

memccpy memory (S 

memchr memory (S 

memcmp memory (S 

memcpy memory (S 

memset memory (S 

mesg mesg(C 

messages messages (M. 

micnet micnet(F 

mkdev m£<iev(ADM 

mkdir mkdir (C 

mkdir mkdir(DOS 

mkfs mkfs(ADM 

mkinittab te//mY (ADM 

mknod mknod{C 

mknod mknod(S 

mkstr mkstr(CP 

mktemp mktemp (S 

mkuser mkuser (ADM 



mm mm (CT) 

mmcheck checkmm (CT) 

mmt mmt(CT) 

mnt mnt(C) 

mnttab mnttab(F) 

modf frexpiS) 

monitor monitor (S) 

more more(C) 

mount mount {ADM) 

mount mountiS) 

mouse mouse (EW) 

movedata movedata (DOS) 

mrand48 drand48(S) 

mscreen mscreen (M) 

msgctl msgctl (S) 

msgget msgget(S) 

msgop msgop(S) 

multiscreen .... multiscreen (M) 

mv mv(C) 

mvdir mvdir (ADM) 

nap nap(S) 

nbwaitsem waitsem (S) 
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neqn eqn(CT) 
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netutil netutil (ADM) 

newform newform(C) 

newgrp newgrp(C) 

news news(C) 

nextkey dbm(S) 
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nice nice (S) 

nl n/(C) 

nlist nlist(S) 
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null null (F) a 
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outp outp(DOS) 

pack , pack(C) 
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passwd passwd(C) 

passwd passwd(F) 
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peat pack(C) 

pclose popen(S) 

perror perror(S) 

Pg PgiQ 

pipe pipe(S) 

plock plockiS) 

popen popen(S) 

pow exp (S) 

pr pr(C) 

prep prep (CP) 

printf printf(S) 

proctl proctl'(S) 

prof prof (CP) 

profil profil(S) 

profile profile (M) 

prs /?rs(CP) 

ps ps(C) 

pstat pstat(C) 

ptrace ptrace(S) 

ptx pfic(CT) 

putc putc(S) 

putch putch (DOS) 

putchar putc(S) 

putenv putenv(S) 

putpwent putpwent(S) 

puts puts(S) 

pututline getut(S) 

putw putc(S) 

pwadmin pwadmin(ADM) 

pwcheck pwcheck{C) 

pwd pwd(C) 

qsort qsort(S) 

quot quot(C) 

ramdisk ramdisk(PPW) 

rand randiS) 

random randomiC) 

ranlib ranlib (CP) 

ratfor ratf or (CP) 

rep rcpiC) 

rdchk rdchk(S) 

read read(S) 

readdir directory (S) 
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reboot haltsys (ADM) 

red red(C) 

regemp regemp (CP) 

regemp regex(S) 

regex regex(S) 

regexp regexp (S) 

reject accept (C) 

remote remote (C) 

rename rename (DOS) 

restor restore (C) 

restore restore (C) 

rewind fseek(S) 

rewinddir directory (S) 

rm rra(C) 

rmdel rmdel(CP) 

rmdir rm(C) 

rmdir rmdir (C) 

rmdir rmdir(DOS) 

rmuser rmuser (ADM) 

rsh rsh(C) 

runbig runbig (ADM) 

sact sact(CP) 

sbrk sbrk(S) 

scanf scanf(S) 

sccsdiff sccsdiff(CP) 

sccsfile sccsfile(F) 

schedule schedule (ADM) 

screen screen (HW) 

scsi scsi(HW) 

sdb sdb (CP) 

sddate sddate(C) 

sdenter sdenter(S) 

sdfree sdget(S) 

sdget sdget(S) 

sdgetv sdgetv(S) 

sdiff sdiffOQ 

sdleave sdenter (S) 

sdwaitv sdgetv (S) 

sed sed(C) 

seekdir directory (S) 

segread segread (DOS) 

semctl semctl(S) 

semget semget(S) 

semop semop(S) 

setbuf setbuf(S) 
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setcolor setcolor (C) 
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setkey setkey (C) 

setmnt setmnt(ADM) 

setmode setmode (DOS) 

setpgrp setpgrp(S) 

setpwent getpwent(S) 

settime settime (ADM) 

setuid setuid(S) 

setutent getut(S) 

setvbuf setbuf(S) 

sgetl sputl(S) 

sh sh(C) 

shl shl(C) 

shmctl shmctl (S) 

shmget shmgetiS) 

shmop shmop(S) 

shutdn shutdn(S) 

shutdown shutdown(ADM) 

signal signal (S) 

sigsem sigsem(S) 

sin trig(S) 

sinh sinh(S) 

size s/ze (CP) 

sleep sleep (C) 

sleep sleep (S) 

soelim soelim (CT) 

sopen 5open(DOS) 

sort 5or?(C) 

spawnl spawn(DOS) 

spawnvp spawn(DOS) 

special , eqnchar(CT) 

spell .. spell (CT) 

spellin spell (CT) 

spline spline (CP) 

split split (C) 

sprintf printf(S) 

sputl sputl(S) 

sqrt exp (S) 

srand rand(S) 

sscanf scanf(S) 

ssignal ssignal($) 

stat stat(F 
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stat stat(S) 

stdio stdio(S) 

stime stime (S) 

store dbm(S) 

strcat string (S) 

strcmp string (S) 

strcpy string (S) 

string string (S) 

strings strings (CP) 

strip strip (CP) 

strlen s?r/e«(DOS) 

strlwr sfr/wr (DOS) 

strncat string (S) 

strncmp string (S) 

strncpy string (S) 

strrev strrev (DOS) 

strset strset (DOS) 

strtod strtod(S) 

strtol strtol (S) 

strupr strupr(DOS) 

stty stty(C) 

style style (CT) 

su su(C) 

sum sum(C) 

swab sraz&(S) 

swapadd swapadd(S) 

sxt sjtf (M) 

sync sync (ADM) 

sync 5^nc(S) 

sysadmin sysadmin (ADM) 

sysadmsh sysadmsh(ADM) 

sys_errlist perror(S) 

sys_nerr perror(S) 

system system(S) 

systemid systemid(F) 

systty systty(M) 

tail tail (C) 

tan trig(S) 

tanh sinh(S) 

tape tape (C) 

tape tape(TTW) 

tapedump tapedump(C) 

tar tar(C) 

tar tar(¥ s 

tbl tbl(CT 

tdelete tsearch(S) 



tee tee(C) 

telinit telinit(ADM) 

tell tell (DOS) 

telldir directory (S) 

tempnam tmpnam(S) 

term term (CT) 

term term(F) 

termcap termcap (M) 

terminal terminal (HW) 

terminals terminals (M) 

terminfo terminfo (F) 

terminfo terminfo (M) 

terminfo terminfo (S) 

termio termio (M) 

test test(C) 

tfind tsearch (S) 

tgetent termcap (S) 

tgetflag termcap (S) 

tgetnum termcap (S) 

tgetstr termcap (S) 

tgoto termcap (S) 

tic ftc(C) 

tid ri<i(C) 

time time (CP) 

time time(S) 

times times (S) 

tmpfile tmpfile(S) 

tmpnam tmpnam(S) 

toascii cewv(S) 

toascii cfype (S) 

tolower co«v(S) 

tolower ctype (S) 

top top(F) 

top.next top(F) 

touch touchiC) 

toupper conv(S) 

toupper ctype (S) 

tput tput(C) 

tputs termcap (S) 

tr ?r(C) 

translate translate (C) 

trchan trchan(M) 

troff troff(CT) 

true true(C) 

tsearch teearc/*(S) 

tset tset(C) 



tsort taort(CP; 

tty ffy( c 

tty tty OA. 

ttyname ttyname (S 

ttys ttys (F 

ttyslot tty slot (S 

twalk tsearch (S 

types types (F 

TZ te(M 

tzset crime (S 

uadmin uadmin(S 

ulimit ulimit(S 

ultoa ultoa(DOS 

umask umask(C 

umask umask(S 

umount umount(ADM 

umount umount(S 

uname uname(C 

uname uname (S 

uncompress compress (C 

unget unget(CP 

ungetc ungetciS 

ungetch ungetch (DOS 

uniq uniq(C 

units units (C 

unlink unlink (S 

unpack pack(C 

uptime uptime (C 

usemouse usemouse(C 

ustat ustat(S 

utime utime (S 

utmp utmp(F 

uuchat dial (ADNf 

uucheck uucheck(ADM 

uucico uucico(ADM 

uuclean uuclean(ADM 

uucp uucp(C 

uuencode uuencode(C 

uuinstall uuinstall(ADM 

uulog uucp(C 

uuname uucp(C 

uupick uuto(C 

uusched uusched(ADM 

uustat uustat(C 

uusub uusub(C 

uuto uuto(C 
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uutry uutry (ADM 

mix uux(C 

uuxqt uwcqt (ADM 

val val (CP 

varargs varargs(S 

vedit vz(C 

vfprintf vprintf (S 

vi W(C 

vidi vidi(C 

view v/(C 

vmstat vmstat(C 

vprintf vprintf (S 

vsh vsh(C 

vsprintf vprintf (S 

w w(C 

wait wait(C 

wait wait(S 

waitsem waitsem(S 

wall wall (ADM 

wc wc(C 

what what(C 

who who(C 

whodo whodo(C 

write write (C 

write write (S 

wtmp utmp(¥ 

xargs xargs(C 

xlist xlist(S 

xref xref '(CP 

xstr xy/r(CP 

yO bessel (S 

yl bessel (S 

yacc yacc (CP 

yes je5(C 

yn bessel (S 

zcat compress (C 
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Commands (C) 



intro Introduces XENIX commands. 

accept, reject Allows/prevents print requests to a lineprinter or 

class of printers, 

assign, deassign Assigns and deassigns devices, 

at, batch Executes commands at a later time, 

awk Searches for and processes a pattern in a file, 

backup Performs incremental file system backup, 

banner Prints large letters. 

basename Removes directory names from pathnames. 

be Invokes a calculator. 

bdiff Compares files too large for diff. 

bfs Scans big files. 

cal Prints a calendar. 

calendar Invokes a reminder service. 

capinfo Converts termcap descriptions into terminfo 
descriptions. 

cat Concatenates and displays files, 

cd Changes working directory, 

chgrp Changes group ID. 

chmod Changes the access permissions of a file or directory, 

chown Changes owner ID. 

clear Clears a terminal screen, 

cmchk Reports hard disk block size, 

cmp Compares two files. 

comm Selects or rejects lines common to two sorted files, 
compress, 

uncompress, zcat Compress data for storage, uncompress, display a 
stored file. 

copy Copies groups of files, 

cp Copies files, 

cpio Copies file archives in and out. 

cron Executes commands at specified times, 

csh Invokes a shell command interpreter with C-like 
syntax. 

csplit Splits files according to context, 

ct Spawns getty to a remote terminal, 

cu Calls another XENDC system. 
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date 

dc 

dd 

devnm 

df 

diff 

diflS 

dircmp 

dirname 

disable 

diskcp, diskcmp 
dos, doscat, 
doscp, dosdir, 
dosformat, dosls, 
dosmkdir, dosrm, 
dosrmdir 
dtype 
du 

dump 
dumpdir 
echo 
ed 

enable 

env 

ex 

expr 

factor 

false 

file 

find 

finger 

fixhdr 

format 

getopt 

grep, egrep, fgrep 

grpcheck 

hd 

head 

hello 

help 

hwconfig 
id 

imacct 



Prints and sets the date. 

Invokes an arbitrary precision calculator. 

Converts and copies a file. 

Identifies device name. 

Report number of free disk blocks. 

Compares two text files. 

Compares three files. 

Compares directories. 

Delivers directory part of pathname. 

Turns off terminals and printers. 

Copies or compares floppy disks. 



Access DOS files. 

Determines disk type. 

Summarizes disk usage. 

Performs incremental file system backup. 

Prints the names of files on a backup archive. 

Echoes arguments. 

Invokes the text editor. 

Turns on terminals and line printers. 

Sets environment for command execution. 

Invokes a text editor. 

Evaluates arguments as an expression. 

Factor a number. 

Returns with a nonzero exit value. 
Determines file type. 
Finds files. 

Finds information about users. 
Changes executable binary file headers. 
Format floppy disks. 
Parses command options. 
Searches a file for a pattern. 
Checks group file. 

Displays files in hexadecimal format. 

Prints the first few lines of a stream. 

Send a message to another user. 

Asks for help with XENIX commands and SCCS error 

messages. 

Read the configuration information. 
Prints user and group IDs and names. 
Generate an IMAGEN accounting report. 
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imprint 


Prints text files on an IMAGEN printer. 


inr. oldinr 


Put files into the IMAGEN printer queue. 


iprint 


Converts text files to DVI format. 


join 


Joins two relations. 


kill 


Terminates a process. 


1 


Lists information about contents of directory. 


last 


Indicate last logins of users and teletypes. 


k 


Lists directory contents in columns. 


line 


Reads one line. 


In 


lVTfllcps a link to a flip 


lock 


Locks a user's terminal. 


logname 


Gets login name. 


lp, lpr, cancel 


Send/cancel requests to lineprinter. 


Idf 


Sends files to the lineprinter queue. 


Iprint 


Print to a printer attached to the user's terminal. 


lpstat 


Prints lineprinter status information. 


Is 


Gives information about contents of directories. 


mail 


Sends, reads, or disposes of mail. 


mesg 


Permits or denies messages sent to a terminal. 


mkdir 


Makes a directory. 


mknod 


Builds special files. 


mnt 


Mount a filesystem. 


more 


Views a file one screen full at a time. 


mv 


Moves or renames files. 


newform 


Changes the format of a text file. 


newgrp 


Logs users into a new group. 


news 


Print news items. 


nice 


Runs a command at a different priority. 


nl 


Adds line numbers to a file. 


nohup 


Runs a command immune to hangups and quits. 


od 


Displays files in octal format. 


pack, peat, 




unpack 


Compresses and expands files. 


passwd 


Changes login password. 


D2 


File perusal filter for soft-copy terminals. 


or 


Prints files on the standard output. 


DS 


Reports process status. 


pstat 


Reports system information. 


pwcheck 


Checks password file. 


pwd 


Prints working directory name. 


quot 


Summarizes file system ownership. 


random 


Generates a random number. 


rep 


Copies files across XENIX systems. 


red 


Invokes a restricted version of ed. 
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remote 


Executes 


restore, restor 


Invokes incremental file system restorer. 


rm, rmdir 


Removes files or directories. 


rmdir 


Removes directories. 


rsh 


Invokes a restricted shell (command interpreter). 


sddate 


Prints and sets backup dates. 


sdiff 


Compares files side-by-side. 


sed 


Invokes the stream editor. 


setcolor 


Set screen color. 


setkey 


Assigns the function keys. 


sh 


Invokes the shell command interpreter. 


shl 


Shell layer manager. 


sleep 


Suspends execution for an interval. 


sort 


Sorts and merges files. 


split 


Splits a file into pieces. 


stty 


Sets the options for a terminal. 


su 


Makes the user a super-user or another user. 


sum 


Calculates checksum and counts blocks in a file. 


tail 


Delivers the last part of a file. 


tape 


Magnetic tape maintenance program. 


tapedump 


Dumps magnetic tape to output file. 


tar 


Archives files. 


tee 


Creates a tee in a pipe. 


test 


Tests conditions. 


tic 


Terminfo compiler. 


tid 


Terminfo decompiler. 


touch 


Updates access and modification times of a file. 


tput 


Queries the terminfo database. 


tr 


Translates characters. 


translate 


Translates files from one format to another. 


true 


Returns with a zero exit value. 


tset 


Sets terminal modes. 


tty 


Gets the terminal's name. 


umask 


Sets file-creation mode mask. 


uname 


Prints the name of the current XENK system. 


uniq 


Reports repeated lines in a file. 


units 


Converts units. 


uptime 


Displays information about the system activity. 


usemouse 


Maps mouse input to keystrokes for use with non- 




mouse based programs. 


uucp, uulog, 




uuname 


Copies files from XENDC to XENIX. 


uuencode,uudecode 




Encode/decode a binary file for transmission via mail 
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uustat 


uucp status inquiry and job control. 


uusub 


Monitor uucp network. 


uuto, uupick 


Public XENIX-to-XENIX file copy. 


uux 


Executes command on remote XENIX. 


vi, view, vedit 


Invokes a screen-oriented display editor. 


vidi 


Sets the font and video mode for a video device. 


vmstat 


Reports virtual memory statistics. 


vsh 


Menu driven visual shell. 


w 


Displays information about who is on the system and 




what they are doing. 


wait 


Awaits completion of background processes. 


wc 


Counts lines, words and characters. 


what 


Identifies files. 


who 


Lists who is on the system. 


whodo 


Determines who is doing what. 


write 


Writes to another user. 


xargs 


Constructs and executes commands. 


yes 


Prints string repeatedly. 
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Name 

intro - Introduces XENIX commands. 



Description 

This section describes use of the individual commands available in the 
XENIX Operating System. Each individual command is labeled with 
either a C, a CP, or a CT for easy reference from other volumes. The 
letter "C" stands for "command". The letters "P" and "T" stand 
for commands that come with the optional XENIX Development Sys- 
tem (Programming) and the XENIX Text Processing System, respec- 
tively. For example, the reference date (C) indicates a reference to a 
discussion of the date command in the C section; the reference 
cc (CP) indicates a reference to a discussion of the cc command in the 
XENIX Development System; and the reference spell (CT) indicates a 
reference to a discussion of the spell command in the XENIX Text Pro- 
cessing System. The Text Processing and Development Systems are 
optional supplemental packages to the standard Operating System. 

The "M" Miscellaneous section contains miscellaneous information 
including a great deal of system maintenance information. Other 
reference sections include the "S" System Services section, the 
"DOS" Routines section and the "F" File Format section. 



Syntax 



Unless otherwise noted, commands described in this section accept 
options and other arguments according to the following syntax: 

name [option (s)] [cmdarg(s)] 

where: 



name Is the name of an executable file. 

option - noargletter(s) or, 

- argletter Ooptarg 
where <> is optional whitespace. 

noargletter Is a single letter representing an option without an 
argument. 

argletter Is a single letter representing an option requiring an 
argument. 
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optarg 



Is an argument (character string) satisfying preceding 
argletter . 



cmdarg 



Is a pathname (or other command argument) not 
beginning with -. - by itself indicates the standard 
input. 



See Also 

getopt(C), getopt(S) 
Diagnostics 

Upon termination, each command returns 2 bytes of status, one sup- 
plied by the system and giving the cause for termination:, and (in the 
case of "normal" termination) one supplied by the program (see 
wait(S) and exit(S)). The former byte is for normal termination; the 
latter is customarily for successful execution and nonzero to indicate 
troubles such as erroneous parameters, bad or inaccessible data. It is 
called variously "exit code", "exit status", or "return code", and is 
described only where special conventions are involved. 



Notes 



Not all commands adhere to the syntax described here. 
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Name 

accept, reject - Allows/prevents print requests to a lineprinter or class 
of printers. 



Syntax 

/usr/Iib/accept destinations 
/usr/Iib/reject [ -r[ reason ] ] destinations 



Description 

accept allows lp(C) to accept requests for the named destinations. A 
destination can be either a printer or a class of printers. Use IpstatiC) 
to find the status of destinations . 

reject prevents lp(C) from accepting requests for the named destina- 
tions . A destination can be either a printer or a class of printers. Use 
lpstat(C) to find the status of destinations . The following option is 
useful with reject : 

-r[ reason] Associates a reason with disabling (using disable (C)) 
the printer. The reason applies to all printers listed up to 
the next -r option. If the -r option is not present or the -r 
option is given without a reason, then a default reason is 
used. Reason is reported by Ipstat(C). Please see 
disable(C) for an example of reason syntax. 



Files 

/usr/spool/lp/* 



See Also 

enable(C), lp(C), lpadmin(ADM), lpinit(ADM), lpsched(ADM), 
lpstat(C), disable(C). 
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Name 

assign, deassign - Assigns and deassigns devices. 



Syntax 

assign [ -u ] [ -v ] [ -d ] [ device ] ... 
deassign [ -u ] [ -v ] [ device ] ... 



Description 

assign attempts to assign device to the current user. The device argu- 
ment must be an assignable device that is not currently assigned. An 
assign command without an argument prints a list of assignable dev- 
ices along with the name of the user to whom they are assigned. 

deassign is used to "deassign" devices. Without any arguments, 
deassign will deassign all devices assigned to the user. When argu- 
ments are given, an attempt is made to deassign each device given as 
an argument. 

With these commands you can exclusively use a device, such as a tape 
drive or floppy drive. This keeps other users from using the device. 
They have a similar effect as chown(C) and chmodiC), although they 
only act on devices in /dev. Other aspects are discussed further on. 

Available options include: 

-d Performs the action of deassign . The -d option may be embedded 
in device names to assign some devices and deassign others. 

-v Gives verbose output. 

-u Suppresses assignment or deassignment, but performs error check- 
ing. 

The assign command will not assign any assignable devices if it can- 
not assign all of them, deassign gives no diagnostic if the device can- 
not be deassigned. Devices may be automatically deassigned at 
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logout, but this is not guaranteed. Device names may be just the 
beginning of the device required. For example, 

assign fd 

should be used to assign all floppy disk devices. Raw versions of dev- 
ice will also be assigned, e.g., the raw floppy disk devices /dev/rfd? 
would be assigned in the above example. 

Note that in many installations the assignable devices such as floppy 
disks have general read and write access, so the assign command may 
not be necessary. This is particularly true on single-user systems. Dev- 
ices supposed to be assignable with this command should be owned by 
the user asg. The directory /dev should be owned by bin and have 
mode 755. The assign command (after checking for use by someone 
else) will then make the device owned by whoever invokes the com- 
mand, without changing the access permissions. This allows the sys- 
tem administrator to set up individual devices that are freely avail- 
able, assignable (owned by asg), or nonassignable and restricted (not 
owned by asg and with some restricted mode). 

Note that the first time assign is invoked, it builds the assignable dev- 
ices table /etc/atab . This table is used in subsequent invocations to 
save repeated searches of the /dev directory. If one of the devices in 
/dev is changed to be assignable (i.e., owned by asg), then /etc/atab 
should be removed (by the super-user) so that a correct list will be 
built the next time the command is invoked. 



Return Values 

Exit code returned if successful, 1 if problems, 2 if device cannot be 
assigned. 
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Name 

at, batch - Executes commands at a later time. 



Syntax 

at time [ date ] [ + increment ] 

at -r job ... 

at-l[job...] 

at -q[ letter ] time [ date ] [job ... ] 



Description 

at and batch read commands from the standard input to be executed at 
a later time, at allows you to specify a time when the commands 
should be executed, while batch executes jobs when the system load 
level permits. 

Standard output and standard error output are mailed to the user unless 
they are redirected elsewhere. The shell environment variables, 
current directory, umask, and ulimit are retained when the commands 
are executed. Open file descriptors, traps, and priorities are lost. 

A user is permitted to use at if his name appears in the file 
/usr/lib/cron/at.allow. If that file does not exist, the file 
/usr/lib/cron/at.deny is checked to determine if the user should be 
denied access to at. If neither file exists, only root is allowed to sub- 
mit a job. If only the at.deny file exists, global usage is permitted. 
The allow/deny files consist of one user name per line. 

The options are: 

time The time may be specified as 1, 2, or 4 digits. One- and two- 
digit numbers are taken to be hours, four digits to be hours and 
minutes. The time may alternately be specified as two numbers 
separated by a colon, meaning hour -.minute . A suffix am or pm 
may be appended; otherwise a 24-hour clock time is understood. 
The suffix zulu may be used to indicate GMT. The special 
names noon, midnight, now, and next are also recognized. 

date An optional date may be specified as either a month name fol- 
lowed by a day number (and possibly year number preceded by 
an optional comma) or a day of the week (fully spelled or abbre- 
viated to three characters). Two special "days", today and 
tomorrow, are recognized. If no date is given, today is 
assumed if the given hour is greater than the current hour and 
tomorrow is assumed if it is less. If the given month is less 
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than the current month (and no year is given), next year is 
assumed. 

increment 

The optional increment is simply a number suffixed by one of 
the following: minutes, hours, days, weeks, months, or years. 
(The singular form is also accepted.) Thus, legitimate com- 
mands include: 

at 08 15am Jan 24 

at 8:15am Jan 24 

at now + 1 day 

at 5 pm Friday 

-r Removes jobs previously scheduled by the at or 
batch command. Unless you are the super-user, you can only 
remove your own jobs. 

-1 Lists all the jobs currently scheduled for the invoking user. 

-qletter 

Places the specified job in a queue denoted by letter, where 
letter is any letter from "a" to "z" (not uppercase). The queue 
letter is appended to the job number. The following letters have 
special significance: 

a at queue 
b batch queue 
c cron queue 

at and batch write the job number and schedule time to standard error. 
batch submits a batch job. It is almost equivalent to "at now," but 
with a difference: batch goes into a different queue; at now will 
respond with the error message too late. 



Examples 

The at and batch commands read the commands to be executed at a 
later time from the standard input. ,s7z(C) provides different ways of 
specifying standard input. Within your commands, it may be useful to 
redirect standard output. 

The following sequence can be used at a terminal: 
batch 

nroff filename > outfile 

<Ctrl-D> (press "Ctrl" and press "D") 
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This sequence, which demonstrates redirecting standard error to a pipe 
( I ), is useful in a shell procedure (the sequence of output redirection 
specifications is significant): 

batch «! 

nxofi filename 2>&1 >outfile I mail 
loginid 



To have a job reschedule itself, invoke at from within the shell pro- 
cedure by including code similar to the following within the shell file: 

echo "sh shellfile" I at 1900 thursday next week 

The most simple use of at is to specify that a given command or regu- 
lar file containing commands, file, be run on the date specified: 
at date < file 



Files 

/usr/lib/cron 

/usr/lib/cron/at.allow 

/usr/lib/cron/at.deny 

/usr/lib/cron/queue 

/usr/spool/cron/atjobs 



main cron directory 
list of allowed users 
list of denied users 
scheduling information 
spool area 



See Also 

cron(C), kill(C), mail(C), nice(C), ps(C), sh(C) 



Diagnostics 

Complains about syntax errors and times out of range. 
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Name 

awk — Pattern scanning and processing language. 



Syntax 

awk [ — F re ] [ parameter... ] [ 'prog' ] [ — f progfile ] [ file... ] 



Description 

The — F re option defines the input field separator to be the regular 
expression re. 

Parameters, in the form x=... y=... may be passed to awk, where x and 
y are awk built-in variables (see list below). 

awk scans each input file for lines that match any of a set of patterns 
specified in prog. The prog string must be enclosed in single quotes 
(') to protect it from the shell. For each pattern in prog there may be 
an associated action performed when a line of a file matches the pat- 
tern. The set of pattern-action statements may appear literally as prog 
or in a file specified with the — f progfile option. 

Input files are read in order; if there are no files, the standard input is 
read. The file name — means the standard input. Each input line is 
matched against the pattern portion of every pattern-action statement; 
the associated action is performed for each matched pattern. 

An input line is normally made up of fields separated by white space. 
(This default can be changed by using the FS built-in variable or the 
— F re option.) The fields are denoted $1, $2, ...; $0 refers to the 
entire line. 

A pattern-action statement has the form: 
pattern { action } 

Either pattern or action may be omitted. If there is no action with a 
pattern, the matching line is printed. If there is no pattern with an 
action, the action is performed on every input line. 

Patterns are arbitrary Boolean combinations ( !, | |, &&, and 
parentheses) of rational expressions and regular expressions. A rela- 
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tional expression is one of the following: 

expression relop expression 
expression matchop regular expression 

where a relop is any of the six relational operators in C, and a matchop 
is either ~ (contains) or ! ~ (does not contain). A conditional is an 
arithmetic expression, a relational expression, the special expression 

var in array, 

or a Boolean combination of these. 

The special patterns BEGIN and END may be used to capture control 
before the first input line has been read and after the last input line has 
been read respectively. 

Regular expressions are as in egrep (see grep(C)). In patterns they 
must be surrounded by slashes. Isolated regular expressions in a pat- 
tern apply to the entire line. Regular expressions may also occur in 
relational expressions. A pattern may consist of two patterns 
separated by a comma; in this case, the action is performed for all 
lines between an occurrence of the first pattern and next occurrence of 
the second pattern. 

A regular expression may be used to separate fields by using the — F 
re option or by assigning the expression to the built-in variable FS . 
The default is to ignore leading blanks and to separate fields by blanks 
and/or tab characters. However, if FS is assigned a value, leading 
blanks are no longer ignored. 

Other built-in variables include: 



ARGC command line argument count 

ARGV command line argument array 

FILENAME name of the current input file 

FNR ordinal number of the current record in the current file 

FS input field separator regular expression (default blank) 

NF number of fields in the current record 

NR ordinal number of the current record 

OFMT output format for numbers (default % .6g) 

OFS output field separator (default blank) 

ORS output record separator (default new-line) 

RS input record separator (default new-line) 
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An action is a sequence of statements. A statement may be one of the 
following: 

if ( conditional ) statement [ else statement ] 

while ( conditional ) statement 

do statement while ( conditional ) 

for ( expression ; conditional ; expression ) statement 

for ( var in array ) statement 

delete array [subscript] 

break 

continue 

{ [ statement ] ... } 

expression # commonly variable = expression 
print [ expression-list ] [ >expression ] 
printf format [ , expression-list ] [ >expression ] 
next # skip remaining patterns on this input line 

exit [expr] # skip the rest of the input; exit status is expr 
return [expr] 

Statements are terminated by semicolons, new lines, or right braces. 
An empty expression-list stands for the whole input line. Expressions 
take on string or numeric values as appropriate, and are built using the 
operators +, — , *,/,%, and concatenation (indicated by a blank). The 

C operators ++, , +=, — =, *=, /=, and %= are also available in 

expressions. Variables may be scalars, array elements (denoted x[i]), 
or fields. Variables are initialized to the null string or zero. Array 
subscripts may be any string, not necessarily numeric; this allows for a 
form of associative memory. String constants are quoted ("). 

The print statement prints its arguments on the standard output, or on 
a file if >expression is present, or on a pipe if | cmd is present. The 
arguments are separated by the current output field separator and ter- 
minated by the output record separator. The printf statement formats 
its expression list according to the format (see printf(S) in the 
Programmer's Reference Manual). 

awk has a variety of built-in functions: arithmetic, string, 
input/output, and general. 

The arithmetic functions are: atan2, cos, exp, int, log, rand, sin, sqrt, 
and srand. int truncates its argument to an integer, rand returns a ran- 
dom number between and 1. srand ( expr ) sets the seed value for 
ran d to expr or uses the time of day if expr is omitted. 

The string functions are: 



gsubifor, repl, in) 

behaves like sub (see below), except that it replaces 
successive occurrences of the regular express (like 
the ed global substitute command). 
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indexes, t) returns the position in string s where string t first 
occurs, or if it does not occur at all. 

length(s) returns the length of its argument taken as a string, or 

of the whole line if there is no argument. 

matchis, re) returns the position in string s where the regular 
expression re occurs, or if it does not occur at all. 
RSTART is set to the starting position (which is the 
same as the returned value), and RLENGTH is set to 
the length of the matched string. 

split(s, a,fs) splits the string s into array elements a[l], a[2], a[ri], 
and returns to n. The separation is done with the reg- 
ular expression fs or with the field separator FS if fs 
is not given. 

sprintfifmt, expr, expr, ...) 

formats the expressions according to the printf(S) 
format given by fmt and returns the resulting string. 

subifor, repl, in) substitutes the string repl in place of the first 
instance of the regular expression for in string in and 
returns the number of substitutions. If in is omitted, 
awk substitutes in the current record ($0). 

substr(s, m, n) returns the n-character substring of s that begins at 
position m. 

The input/output and general functions are: 

closeifilename) closes the file or pipe named filename. 

cmd\getline pipes the output of cmd into getline; each successive 
call to getline returns the next line of output from 
cmd. 

getline sets $0 to the next input record from the current input 

file. 

getline <file sets $0 to the next record from file. 

getline var sets variable var instead. 

getline var <file sets var from the next record of file. 

system(cmd) executes cmd and returns to its exit status. 

All forms of getline return 1 for successful input, for end of file, and 
— 1 for an error. 
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awk also provides user-defined functions. Such functions may be 
defined (in the pattern position of a pattern-action statement) as 

function name(args,...) { stmts } 
func name(args,...) { stmts } 

Function arguments are passed by value if scalar and by reference if 
array name. Argument names are local to the function; all other vari- 
able names are global. Function calls may be nested and functions 
may be recursive. The return statement may be used to return a 
value. 

Examples 

Print lines longer than 72 characters: 
length > 72 

Print first two fields in opposite order: 
{ print $2, $1 } 

Same, with input fields separated by comma and/or blanks and tabs: 

BEGIN { FS = ",[ \t]*[ \f]+" } 
{ print $2, $1 } 

Add up the first column, print sum and average: 
{ s += $1 } 

END { print "sum is", s, " average is", s/NR } 

Print fields in reverse order: 

{ for (i = NF; i > 0; i) print $i } 

Print all lines between start/stop pairs: 
/start/, /stop/ 

Print all lines whose first field is different from previous one: 
$1 != prev { print; prev = $1 } 



May 16, 1988 



Page 5 



AWK(C) 



AWK(C) 



Simulate echo(C): 

BEGIN { 

for (i = 1; i < ARGC; i++) 

printf "%s", ARGVfi] 
printf "\n" 
exit 
} 



Print file, filling in page numbers starting at 5: 

/Page/ { $2 = n++; } 
{ print } 

command line: awk — f program n=5 input 



See Also 

grep(C), sed(C). 

lex(CP), printf(S) in the Programmer' s Reference Manual. 



Bugs 

Input white space is not preserved on output if fields are involved. 

There are no explicit conversions between numbers and strings. To 
force an expression to be treated as a number add to it; to force it to 
be treated as a string concatenate the null string (" ") to it. 
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Name 

backup - Performs incremental file system backup. 



Syntax 

backup [ key [ arguments ]filesystem ] 



Description 

backup copies all files changed after a certain date in the date in the 
filesystem. The key specifies the date and other options about the 
backup, where a key consists of characters from the set 
0123456789kfusd. The meanings of these characters are described 
below: 

f Places the backup on the next argument file instead of the 
default device. 

u If the backup completes successfully, writes the date of the 
beginning of the backup to the file /etc/ddate. This file records 
a separate date for each file system and each backup level. 

0-9 This number is the "backup level". Backs up all files modified 
since the last date stored in the file /etc/ddate for the same file 
system at lesser levels. If no date is determined by the level, the 
beginning of time is assumed; thus the option causes the entire 
file system to be backed up. 

s For backups to magnetic tape, the size of the tape is specified in 
feet. The number of feet is taken from the next argument. 
When the specified size is reached, backup will wait for reels to 
be changed. The default size is 2,300 feet. 

d For backups to magnetic tape, the density of the tape, expressed 
in BPI, is taken from the next argument. This is used in calcu- 
lating the amount of tape used per write. The default is 1600. 

k This option is used when backing up to a block-structured dev- 
ice, such as a floppy disk. The size (in K-bytes) of the volume 
being written is taken from the next argument. If the k argument 
is specified, any s and d arguments are ignored. The default is 
to use s and d. 

If no arguments are given, the key is assumed to be 9u and a default 
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file system is backed up to the default device. 
The first backup should be a full level-0 backup: 
backup Ou 

Next, periodic level 9 backups should be made on an exponential pro- 
gression of tapes or floppies: 

backup 9u 
This progression is shown as follows: 

1 2 1 3 1 2 1 4 ... 

where backup 1 is used every other time, backup 2 every fourth, 
backup 3 every eighth, etc.) When the level-9 incremental backup 
becomes unmanageable because a tape is full or too many floppies are 
required, a level- 1 backup should be made: 

backup lu 

After this, the exponential series should progress as if uninterrupted. 
These level-9 backups are based on the level- 1 backup, which is based 
on the level-0 full backup. This progression of levels of backups can 
be carried as far as desired. 

The default file system and the backup device depend on the settings 
of the variables DISK and TAPE, respectively, in the file 
/etc/ default/backup. 



Files 

/etc/ddate Records backup dates of file system/level 

/etc/default/backup Default backup information 



See Also 

XENIX System Administrator' s Guide 

cpio(C), default(F), dumpdir(C), restore(C), sddate(C), backup(F) 
Diagnostics 

If the backup requires more than one volume (where a volume is likely 
to be a floppy disk or tape), you will be asked to change volumes. 
Press RETURN after changing volumes. 
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Notes 

Sizes are based on 1600 BPI for blocked tape; the raw magnetic tape 
device has to be used to approach these densities. Write errors to the 
backup device are usually fatal. Read errors on the file system are 
ignored. 

If the default archive medium specified in I etc I default! backup or 
i 'etc/ 'default/ 'restor is block structured, (i.e. floppy disk) then the 
volume size in Kbytes must be specified on the command line. Nei- 
ther utility works correctly without this information. For example, 
using the default device (below) with the backup command, enter the 
following: backup k 360 The default device entry for 
i 'etc/ 'default/ backup (tape=/dev/xxx) and /etc/ default/ restor 
(archive=/dev/xxx) is /dev/rfd02. 

It is not possible to successfully restore an entire active root file sys- 
tem. 



Warning 

When backing up to floppy disks, be sure to have enough formatted 
floppies ready before starting a backup. You must also be sure to close 
the floppy door when inserting floppy disks. If you fail to do so in a 
multi-floppy backup, the entire backup will fail and you will have to 
begin again. 

You should never backup more than one filesystem to the tape devices 
IdevlnrctO and Idevlnrctl. This is because, although backup can write 
more than one filesystem to IdevlnrctO or Idevlnrct2, restore may not 
be able to restore more than one filesystem from these devices. 
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Name 

banner - Prints large letters. 

Syntax 

banner strings 

Description 

banner prints its arguments (each up to 10 characters long) in large 
letters on the standard output. This is useful for printing names at the 
front of printouts. 

See Also 

echo(C) 
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Name 

basename - Removes directory names from pathnames. 



Syntax 

basename string [ suffix ] 



Description 

basename deletes any prefix ending in / and the suffix (if present in 
string) from string, and prints the result on the standard output. The 
result is the "base" name of the file, i.e., the filename without any 
preceding directory path and without an extension. It is used inside 
substitution marks ( v v ) in shell procedures to construct new 
filenames. 

The related command dirname deletes the last level from string and 
prints the resulting path on the standard output. 



Examples 

The following command displays the filename memos on the standard 
output: 

basename /usr/johnh/memos.old .old 

The following shell procedure, when invoked with the argument 
/usr/src/cmd/cat.c, compiles the named file and moves the output to a 
file named cat in the current directory: 

cc $1 

mv a.out s basename $1 .c v 



See Also 

dirname(C), sh(C) 
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Name 

be - Invokes a calculator. 



Syntax 

be [ -c ] [ -1 ] [ file ... ] 



Description 

be is an interactive processor for a language that resembles C but pro- 
vides unlimited precision arithmetic. It takes input from any files 
given, then reads the standard input. The -1 argument stands for the 
name of an arbitrary precision math library. The syntax for be pro- 
grams is as follows: L means the letters a-z, E means expression, S 
means statement. 

Comments: 

Enclosed in /* and */ 

Names: 

Simple variables: L 

Array elements: L [ E ] 

The words "ibase", "obase", and "scale" 

Other operands: 

Arbitrarily long numbers with optional sign and decimal point 
(E) 

sqrt ( E ) 

length ( E ) Number of significant decimal digits 
scale ( E ) Number of digits right of decimal point 

L(E,...,E) 

Additive operators: 
+ 



Multiplicative operators: 

* 

/ 

% (remainder) 
" (exponentiation) 
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Unary operators: 
++ 

(prefix and postfix; apply to names) 
Relational operators: 

<= 
>= 

!- 

< 

> 

Assignment operators: 



=+ 



=* 

=/ 
=% 



Statements: 
E 

{ S ; ... ; S } 

if(E)S 

while ( E ) S 

for ( E ; E ; E ) S 

null statement 

break 

quit 

Function definitions: 

define L ( L L ) { 
auto L, ... , L 
S; ...S 
return ( E ) 

} 
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Functions in 


-1 math library: 


s(x) 


Sine 


c(x) 


Cosine 


e(x; 


Exponential 


l(x) 


Log 


a(x) 


Arctangent 


j(n,x) 


Bessel function 



All function arguments are passed by value. 

The value of a statement that is an expression is printed unless the 
main operator is an assignment. Either semicolons or newlines may 
separate statements. Assignment to scale influences the number of 
digits to be retained on arithmetic operations in the manner of dc(C). 
Assignments to ibase or obase set the input and output number radix 
respectively. 

The same letter may be used as an array, a function, and a simple vari- 
able simultaneously. All variables are global to the program. "Auto" 
variables are pushed down during function calls. When using arrays 
as function arguments or defining them as automatic variables, empty 
square brackets must follow the array name. 

be is actually a preprocessor for dc(C), which it invokes automati- 
cally, unless the -c (compile only) option is present. If the -c option is 
present, the dc input is sent to the standard output instead. 



Example 

The following defines a function to compute an approximate value of 
the exponential function: 



scale = 20 
define e(x){ 

auto a, b, c, i, s 

a= 1 

b= 1 

s= 1 

for(i=l; 1==1; i++){ 
a = a*x 
b = b*i 
c = a/b 

if(c == 0) return(s) 
s = s+c 

} 

} 
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The following prints the approximate values of the exponential func- 
tion of the first ten integers: 

for(i=l; i<=10; i++) e(i) 



See Also 

dc(C) 

The XENIX User's Guide 
Notes 

A For statement must have all three E's. 

Quit is interpreted when read, not when executed. 

Trigonometric values should be given in radians. 



Files 



/usr/lib/lib.bc 



Mathematical library 
Desk calculator proper 



/usr/bin/dc 
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Name 

bdiff - Compares files too large for dijf. 



Syntax 

bdiff filel file2 [n] [-s] 



Description 

bdiff compares two files, finds lines that are different, and prints them 
on the standard output. It allows processing of files that are too large 
for dijf. bdiff splits each file into rc-line segments, beginning with the 
first nonmatching lines, and invokes diff upon the corresponding seg- 
ments. The arguments are: 

n The number of lines bdiff splits each file into for processing. The 
default value is 3500. This is useful when 3500-line segments are 
too large for diff. 

-s Suppresses printing of bdiff diagnostics. Note that this does not 
suppress printing of diagnostics from diff. 

If filel (orftle2 ) is a dash (-), the standard input is read. 

The output of bdiff is exactly that of diff. Line numbers are adjusted to 
account for the segmenting of the files, and the output looks as if the 
files had been processed whole. 



Files 

/tmp/bd????? 



See Also 

diff(C) 



Notes 

Because of the segmenting of the files, bdiff does not necessarily find a 
smallest sufficient set of file differences. 

Specify the maximum number of lines if the first difference is too far 
down in the file for diff and an error is received. 
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Name 

bfs - Scans big files. 



Syntax 

bfs [ - ] name 



Description 

bfs is like ed (C) except that it is read-only and processes much larger 
files. Files can be up to 1024K bytes and 32K lines, with up to 255 
characters per line, bfs is usually more efficient than ed for scanning 
a file, since the file is not copied to a buffer. It is most useful for iden- 
tifying sections of a large file where csplit (C) can be used to divide it 
into more manageable pieces for editing. 

Normally, the size of the file being scanned is printed, as is the size of 
any file written with the w command. The optional dash (-) 
suppresses printing of sizes. Input is prompted for with an asterisk (*) 
when "P" and RETURN are typed. The "P" acts as a toggle, so 
prompting can be turned off again by entering another "P" and a 
RETURN. Note that messages are given in response to errors only if 
prompting is turned on. 

All address expressions described under ed are supported. In addition, 
regular expressions may be surrounded with two symbols other than 
the standard slash (/) and (?): A greater-than sign (>) indicates down- 
ward search without wraparound, and a less-than sign (<) indicates 
upward search without wraparound. Note that parentheses and curly 
braces are special and need to be escaped with a backslash (\). Since 
bfs uses a different regular expression-matching routine from ed, the 
regular expressions accepted are slightly wider in scope (see 
regex (S)). Differences between ed and bfs are listed below: 

+ A regular expression followed by + means one or more times . 
For example, [0-9]+ is equivalent to [0-9] [0-9]*. 

\{m\} \{m,\} \{m,u\} 

Integer values enclosed in \{ \} indicate the number of times 
the preceding regular expression is to be applied, m is the 
minimum number and u is a number, less than 256, which is 
the maximum. If only m is present (e.g.,\{m\}), it indicates 
the exact number of times the regular expression is to be 
applied. \{m,\} is analogous to \{m,infinity\}. The plus (+) 
and star (*) operations are equivalent to \{1,\} and \{0,\} 
respectively. 
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( . . . )%n The value of the enclosed regular expression is to be 
returned. The value will be stored in the (n+1 )th argument 
following the subject argument. At most ten enclosed regular 
expressions are allowed, regex makes its assignments uncon- 
ditionally. 

(...) Parentheses are used for grouping. An operator, e.g. *, +, 
\{ \}, can work on a single character or a regular expression 
enclosed in parenthesis. For example, Xa*\(cb+\)*\)$0. 

There is also a slight difference in mark names: only the letters "a" 
through "z" may be used, and all 26 marks are remembered. 

The e, g, v, k, p, q, w, =, ! and null commands operate as described 
under ed except that e doesn't remember filenames and g and v when 
given no arguments return the line after the line you were on. Com- 
mands such as +++-, +++=, -12, and +4p are accepted. Note that 
l,10p and 1,10 will both print the first ten lines. The f command only 
prints the name of the file being scanned; there is no remembered 
filename. The w command is independent of output diversion, trunca- 
tion, or crunching (see the xo, xt and xc commands, below). The fol- 
lowing additional commands are available: 

xffile 

Further commands are taken from the named file. When an 
end-of-file is reached, an interrupt signal is received, or an error 
occurs, reading resumes with the file containing the xf. Xf com- 
mands may be nested to a depth of 10. 

xo [file ] 

Further output from the p and null commands is diverted to the 
named file. If file is missing, output is diverted to the standard 
output. Note that each diversion causes truncation or creation 
of the file. 

: label 

This positions a label in a command file. The label is ter- 
minated by a newline, and blanks between the : and the start of 
the label are ignored. This command may also be used to insert 
comments into a command file, since labels need not be refer- 
enced. 

( . , . )xb/regular expression/label 

A jump (either upward or downward) is made to label if the 
command succeeds. It fails under any of the following condi- 
tions: 

1. Either address is not between 1 and $. 

2. The second address is less than the first. 
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3. The regular expression doesn't match at least one line 
in the specified range, including the first and last lines. 

On success, dot (.) is set to the line matched and a jump is made 
to label. This command is the only one that doesn't issue an 
error message on bad addresses, so it may be used to test 
whether addresses are bad before other commands are executed. 
Note that the command 

xb/7 label 

is an unconditional jump. 

The xb command is allowed only if it is read from somewhere 
other than a terminal. If it is read from a pipe only a downward 
jump is possible. 

xt number 

Output from the p and null commands is truncated to a max- 
imum of number characters. The initial number is 255. 

xv[digit] [spaces] [value] 

The variable name is the specified digit following the xv. 
Xv5100 or xv5 100 both assign the value 100 to the variable 5. 
Xv61,100p assigns the value l,100p to the variable 6. To refer- 
ence a variable, put a % in front of the variable name. For 
example, using the above assignments for variables 5 and 6: 

l,%5p 

1,%5 

%6 

prints the first 100 lines. 
g/%5/p 

globally searches for the characters 100 and prints each line 
containing a match. To escape the special meaning of %, a \ 
must precede it. For example, 

g/".*\%[cds]/p 

could be used to match and list lines containing printf charac- 
ters, decimal integers, or strings. 

Another feature of the xv command is that the first line of output 
from a XENIX command can be stored into a variable. 



May 16, 1988 



Page 3 



BFS (C) 



BFS (C) 



The only requirement is that the first character of value be a !. 
For example, 

xv5! cat junk 
Irmjunk 
!echo "%5" 
xv6!expr %6 + 1 

puts the current line in variable 5, prints it, and increments the 
variable 6 by one. To escape the special meaning of ! as the first 
character of value , precede it with a \. For example, 

xv7V.date 

stores the value Idate into variable 7. 
xbz label 
xbn label 

These two commands test the last saved return code from the 
execution of a XENIX command (Icommand) or nonzero value, 
respectively, and jump to the specified label. The two examples 
below search for the next five lines containing the string size: 

xv55 



May 16, 1988 



Page 4 



CAL(C) 



CAL(C) 



Name 

cal - Prints a calendar. 



Syntax 

cal [[ month ] year] 



Description 

cal prints a calendar for the specified year. If a month is also speci- 
fied, a calendar for that month only is printed. If no arguments are 
specified, the current, previous, and following months are printed, 
along with the current date and time. The year must be a number 
between 1 and 9999; month must be a number between 1 and 12 or 
enough characters to specify a particular month. For example, May 
must be given to distinguish it from March, but S is sufficient to 
specify September. If only a month string is given, only that month of 
the current year is printed. 



Notes 

Beware that "cal 84" refers to the year 84, not 1984. 

The calendar produced is that for England and her colonies. Note that 
England switched from the Julian to the Gregorian calendar in Sep- 
tember of 1752, at which time eleven days were excised from the year. 
To see the result of this switch, try "cal 9 1752". 
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Name 

calendar - Invokes a reminder service. 



Syntax 

calendar [ - ] 



Description 

calendar consults the file calendar in the user's current directory and 
mails him lines that contain today's or tomorrow's date. Most reason- 
able month-day dates, such as "Sep. 7," "September 7", and "9/7", 
are recognized, but not "7 September", "7/12" or "07/12". 

On weekends "tomorrow" extends through Monday. Lines that con- 
tain the date of a Monday will be sent to the user on the previous Fri- 
day. This is not true for holidays. 

When an argument is present, calendar does its job for every user who 
has a file calendar in his login directory and sends the result to the 
standard output. Normally this is done daily, in the early morning, 
under the control of cron (C). 



Files 

calendar 

/usr/lib/calprog To figure out today's and tomorrow's dates 

/etc/passwd 

/tmp/cal* 



See Also 

cron(C), mail(C) 



Notes 

To get reminder service, a user's calendar file must have read permis- 
sion for all. 
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Name 

capinfo, fixpad - convert termcap descriptions into terminfo descrip- 
tions. 



Syntax 

capinfo capfile infofile 
fixpad 



Description 

capinfo invokes an ex(C) script to begin the conversion of a termcap 
terminal description into the equivalent terminfo description, capinfo 
calls fixpad to convert the padding specif cations. The conversion 
needs to be completed by hand. The following should be given spe- 
cial attention: 

- Many terminfo capabilities do not have termcap equivalents. 
The XENIX extensions to termcap do not have terminfo 
equivalents. 

- The termcap capabilities cr, nl, and ht 

are noted in the ex script as being problematical. 



See Also 

termcap(M), terminfo(M), terminfo(F), tic(C) 
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Name 

cat - Concatenates and displays files. 



Syntax 

cat [ -u ] [ -s ] [ -v ] [ -t ] [ -e ] file . . . 



Description 

cat reads each file in sequence and writes it on the standard output. If 
no input file is given, or if a single dash (-) is given, cat reads from the 
standard input. The options are: 

-s Suppresses warnings about nonexistent files. 

-u Causes the output to be unbuffered. 

-v Causes non-printing characters (with the exception of tabs, new- 
lines, and form feeds) to be displayed. Control characters are 
displayed as ""X" (Ctrl-X); the DEL character (octal 0177) is 
printed as ""?." Non- ASCII characters (with the high bit set) are 
printed as "M -x," where x is the character specified by the seven 
low order bits. 

-t Causes a tab to be printed as " A I." This option is ignored if the -v 
option is not specified. 

-e Causes a "$" character to be printed at the end of each line (prior 
to the new-line). This option is ignored if the -v option is not set. 

No input file may have the same name as the output file unless it is a 
special file. 



Examples 

The following example displays file on the standard output: 
cat file 

The following example concatenates filel and file2 and places the 
result in file3 : 

cat filel file2 >file3 

The following example concatenates filel and appends it to file2 : 
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cat filel » file2 

See Also 

cp(C),pr(C) 

Warning 

Command lines such as: 

cat file 1 file2 > filel 

will cause the original data in filel to be lost; therefore, you must be 
careful when using special shell characters. 
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Name 

cd - Changes working directory. 



Syntax 

cd [ directory ] 



Description 

If specified, directory becomes the new working directory; otherwise 
the value of the shell parameter $HOME is used. The process must 
have search (execute) permission in all directories (components) 
specified in the full pathname of directory . 

Because a new process is created to execute each command, cd would 
be ineffective if it were written as a normal command; therefore, it is 
recognized and executed by the shell. 

If the shell is reading its commands from a terminal, and the specified 
directory does not exist (or some component cannot be searched), 
spelling correction is applied to each component of directory, in a 
search for the "correct' ' name. The shell then asks whether or not to 
try and change directory to the corrected directory name; an answer of 
n means "no", and anything else is taken as "yes". 



Notes 

Wildcard designators will work with the cd command. 



See Also 

pwd(C), sh(C), chdir(S) 
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Name 

chgrp - Changes group ID. 

Syntax 

chgrp group file ... 

Description 

chgrp changes the group ID of each//7e to group. The group may be 
either a decimal group ID or a group name found in the file /etc/group. 

Files 

/etc/passwd 
/etc/group 

See Also 

chown(C), chown(S), passwd(F), group(F) 
Notes 

Only the owner or the super-user can change the group ID of a file. 



May 16, 1988 



Page 1 



CHMOD (C) 



CHMOD (C) 



Name 

chmod - Changes the access permissions of a file or directory. 

Syntax 

chmod mode file ... 

chmod [who] +-= [permission ...]file ... 
Description 

The chmod command changes the access permissions (or mode) of a 
specified file or directory. It is used to control file and directory access 
by users other than the owner and super-user. The mode may be an 
expression composed of letters and operators (called symbolic mode), 
or a number (called absolute mode). 

A chmod command using symbolic mode has the form: 

chmod [who] +-= [permission ...] filename 

In place of who you can use one or any combination of the following 
letters: 

a Stands for "all users". If who is not indicated on the command 
line, a is the default. The definition of "all users" depends on the 
user's umask. See umask(C). 

g Stands for "group", all users who have the same group ID as the 
owner of the file or directory. 

o Stands for ' 'others' ', all users on the system. 

u Stands for ' 'user' ', the owner of the file or directory. 

The operators are: 

+ Adds permission 

- Removes permission 

= Assigns the indicated permission and removes all other permis- 
sions (if any) for that who. If no permission is assigned, existing 
permissions are removed. 

Permissions can be any combination of the following letters: 

x Execute (search permission for directories) 
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r Read 
w Write 

s Sets owner or group ID on execution of the file to that of the owner 
of the file. The mode "u+s" sets the user ID bit for the file. The 
mode "g+s" sets the group ID bit. Other combinations have no 
effect. 

t Saves text in memory upon execution. ("Sticky bit", see 
chmod(S)). Only the mode "u+t" sets the sticky bit. All other 
combinations have no effect. This mode can only be set by the 
super-user. 

1 Mandatory locking will occur during access 

Multiple symbolic modes may be given, separated by commas, on a 
single command line. See the following Examples section for sample 
permission settings. 

Mandatory file and record locking refers to a file's ability to have it's 
reading or writing permissions locked while a program is accessing 
that file. A file cannot have group execution permission and be able to 
be locked on execution. In addition, it is not possible to turn on the 
set-group-ID and enable a file to be locked on execution at the same 
time. The following examples show illegal uses of chmod and will 
generate error messages: chmod g+x,+l filename 

chmod g+s,+l filename 

A chmod command using absolute mode has the form: 

chmod mode filename 

where mode is an octal number constructed by performing logical OR 
on the following: 

4000 Set user ID on execution 

20#0 Set group ID on execution if "#" is 7, 5, 3, or 1 and 
enable mandatory locking if "#" is 6, 4, 2, or 0. 

1000 Sets the sticky bit (see chmod(S)) 

0400 Read by owner 

0200 Write by owner 

0100 Execute (search in directory) by owner 
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0040 



Read by group 



0020 



Write by group 



0010 



Execute (search in directory) by group 



0004 



Read by others 



0002 



Write by others 



0001 



Execute (search in directory) by others 



0000 



No permissions 



Examples 

Symbolic Mode 

The following command gives all users execute permission for file: 
chmod +xfile 

The following command removes read and write permission for group 
and others horn file: 

chmod go-rw file 

The following command gives other users read and write permission 
for file: 

chmod o+vw file 

The following command gives read permission to group and other: 
chmod g+r,o+r file 

Absolute Mode 

The following command gives all users read, write and execute per- 
mission for file: 

chmod 0777 file 

The following command gives read and write permission to all users 
for file: 

chmod 0666 file 
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The following command gives read and write permission to the owner 
of file only: 

chmod 0600 file 

The following example causes the file to be locked on access: 

chmod +1 file 

See Also 

ls(C), chmod(S) 

Notes 

The user ID, group ID and sticky bit settings are only useful for binary 
executable files. They have no effect on shell scripts. 
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Name 

chown - Changes owner ID. 

Syntax 

chown owner file ... 

Description 

chown changes the owner ID of the files to owner. The owner may be 
either a decimal user ID or a login name found in the file /etc/passwd. 

Files 

/etc/passwd 
/etc/group 

See Also 

chgrp(C), chown(S), group(F), passwd(F) 
Notes 

Only the owner or the super-user can change a file's owner or group 
ID. 
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Name 

clear - Clears a terminal screen. 

Syntax 

clear [ term ] 

Description 

The clear command clears the screen. If term is not specified, the ter- 
minal type is obtained from the TERM environment variable. 

If a video terminal does not have a clear screen capability, newlines 
are output to scroll the screen clear. If the terminal is a hardcopy, the 
paper is advanced to the top of the next page. 

Files 

/etc/termcap 

See Also 

environ(M), termcap(M), tput(C) 

Notes 

If the standard output is not a terminal, clear issues an error message. 
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Name 

cmchk - Reports hard disk block size. 

Syntax 
cmchk 

Description 

Reports the hard disk block size (BSIZE) in bytes. 
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Name 

cmp - Compares two files. 

Syntax 

cmp [ -1 ] [ -s ] filel file2 

Description 

cmp compares two files and, if they are different, displays the byte and 
line number of the differences. If filel is -, the standard input is used. 

The options are: 

-I Prints the byte number (decimal) and the differing bytes (octal) 
for each difference. 

-s Returns an exit code only, for identical files, 1 for different 
files and 2 for an inaccessible or missing file. 

This command should be used to compare binary files; use diff(C) or 
diff3 (C) to compare text files. 

See Also 

comm(C), diff(C), difiB(C) 

Diagnostics 

Exit code is returned for identical files, 1 for different files, and 2 for 
an inaccessible or missing argument. 
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Name 

comm - Selects or rejects lines common to two sorted files. 



Syntax 

comm [ - [ 123 ] ] filel file2 



Description 

comm reads filel and filel, which should be ordered in ASCII collat- 
ing sequence (see sort (C)), and produces a three-column output: lines 
only in filel ; lines only in filel ; and lines in both files. The filename 
- means the standard input. 

Flags 1 , 2, or 3 suppress printing of the corresponding column. Thus 
comm -12 prints only the lines common to the two files; comm -23 
prints only lines in the first file but not in the second; comm -123 is a 
no-op. 

See Also 

cmp(C), diff(C), sort(C), uniq(C) 



May 16, 1988 



Page 1 



( 



COMPRESS (C) 



COMPRESS (C) 



Name 

compress - compress data for storage, 
uncompress - uncompress a stored file, 
zcat - display a stored file. 



Syntax 

compress [-dfFqc] [-b bits] file 
uncompress [-fqc] file 
zcat file 



Description 

compress takes a file and compresses it to the smallest possible size, 
creates a compressed output file, and removes the original file unless 
the -c option is present. Compression is achieved by encoding com- 
mon strings within the file, uncompress restores a previously 
compressed file to its uncompressed state and removes the 
compressed version, zcat uncompresses and displays a file on the stan- 
dard output. When zcat is used to display a file, the file is 
uncompressed and concatenated on the screen or standard output, and 
the compressed version of the file is not removed. 

If no file is specified on the command line, input is taken from the 
standard input and the output is directed to the standard output. Output 
defaults to a file with the same filename as the input file with the suf- 
fix ".Z" or it can be directed through the standard output. The output 
files have the same permissions and ownership as the corresponding 
input files or the user's standard permissions if output is directed 
through the standard output. 

If no space is saved by compression, the output file is not written 
unless the -F flag is present on the command line. 



Options 

The following options are available from the command line: 
-d Decompresses a compressed file. 

-c Writes output on the standard output and do not remove 

original file. 

-bbits Specifies the maximum number of bits to use in encoding, 
-f Overwrites previous output file. 
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-F Writes output file even if compression saves no space, 

-q Generates no output except error messages, if any. 

See Also 

pack(C), pcat(C), ar(C), tar(C), cat(C) 
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Name 

copy - Copies groups of files. 



Syntax 

copy [ option ] ... source ... dest 



Description 

The copy command copies the contents of directories to another direc- 
tory. It is possible to copy whole file systems since directories are 
made when needed. 

If files, directories, or special files do not exist at the destination, then 
they are created with the same modes and flags as the source. In addi- 
tion, the super-user may set the user and group ID. The owner and 
mode are not changed if the destination file exists. 

Note that there may be more than one source directory. If so, the 
effect is the same as if the copy command had been issued for each 
source directory with the same destination directory for each copy. 

Options do not have to be given as separate arguments, and may 
appear in any order, even after the other arguments. The options are: 

-a Asks the user before attempting a copy. If the response does 

not begin with a "y", then a copy is not done. 

-1 Uses links instead whenever they can be used. Otherwise a 

copy is done. Note that links are never done for special files 
or directories. 

-n Requires the destination file to be new. If not, then the copy 

command does not change the destination file. The -n flag is 
meaningless for directories. For special files an -n flag is 
assumed (i.e., the destination of a special file must not 
exist). 

-o If set then every file copied has its owner and group set to 

those of the source. If not set, then the file's owner is the 
user who invoked the program. 

-m If set, then every file copied has its modification time and 
access time set to that of the source. If not set, then the 
modification time is set to the time of the copy. 

-r If set, then every directory is recursively examined as it is 

encountered. If not set then any directories that are found 
are ignored. 
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-ad Asks the user whether a -r flag applies when a directory is 
discovered. If the answer does not begin with a "y", then 
the directory is ignored. 

-v If the verbose option is set messages are printed that reveal 

what the program is doing. 

Arguments to copy are: 

source This may be a file, directory or special file. It must exist. If 
it is not a directory, then the results of the command are the 
same as for the cp command. 

dest The destination must be either a file or directory that is 
different from the source. 

If the source and destination are anything but directories, then copy 
acts just like a cp command. If both are directories, then copy copies 
each file into the destination directory according to the flags that have 
been set. 



Examples 

This command line verbosely copies all files in the current directory 
to /tmp/food: 

copy -v . /tmp/food 

The next command line copies all files, except for those that begin 
with a period (.), and copies the immediate contents of any child 
directories: 

copy * /tmp/logic 

This command is the same as the previous one, except that it recur- 
sively examines all subdirectories, and it sets group and ownership 
permissions on the destination files to be the same as the source files: 

copy -ro * /tmp/logic 



Notes 

Special device files can be copied. When they are copied, any data 
associated with the specified device is not copied. 
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Name 

cp - Copies files. 



Syntax 

cp filel file2 
cp files directory 



Description 

There are two ways to use the cp command. With the first way, filel 
is copied to file2 . Under no circumstance con filel and file2 be ident- 
ical. With the second way, directory is the location of a directory into 
which one or movefiles are copied. 



See Also 

copy(C), cpio(C), ln(C), mv(C), rm(C), chmod(S) 



Notes 

Special device files can be copied. If the file is a named pipe, then the 
data in the pipe is copied to a regular file. Similarly, if the file is a 
device, then the file is read until the end-of-file is reached, and that 
data is copied to a regular file. It is illegal to copy a directory to a 
file. 
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Name 

cpio - Copies file archives in and out. 



Syntax 

cpio -o [ acBv ] 

cpio -i [ Bcdmrtuvsfb ] [ patterns ] 
cpio -p [ adlmruv ] directory 



Description 

cpio -o (copy out) reads the standard input to obtain a list of path- 
names and copies those files onto the standard output together with 
pathname and status information. 

cpio -i (copy in) extracts from the standard input (which is assumed to 
be the product of a previous cpio -o) the names of files selected by 
zero or more patterns given in the name-generating notation of sh (C). 
In patterns, the special characters ?, *, and [ . . .] match the slash ( / ) 
character. The default for patterns is * (i.e., select all files). 

Remember to escape special characters to prevent expansion by the 
shell. 

cpio -p (pass) copies out and in during a single operation. Destination 
pathnames are interpreted relative to the named directory . 

The meanings of the available options are: 

-a Resets access times of input files after they have been copied. 

-B Blocks input/output 5,120 bytes to the record (does not apply 
to the pass option; meaningful only with data directed to or 
from raw devices). 

-d Directories are created as needed. 

-c Writes header information in ASCII character form for porta- 
bility. 

-r Interactively renames files. If the user types a null line, the 
file is skipped. 

-t Prints a table of contents of the input. No files are created. 
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-u Copies unconditionally (normally an older file will not 
replace a newer file with the same name). 

-v Verbose: causes a list of filenames to be printed. When used 
with the -t option, the table of contents looks like the output 
of an Is -1 command (see Is (C)). ^ 

-1 Whenever possible, links files rather than copying them. 
Usable only with the -p option. If the link cannot be done 
(e.g. the file already exists) the command will abort. 

-m Retains previous file modification time. This option is 
ineffective on directories that are being copied. 

-s Swap bytes within each half word. Use only with the -i 
option. 

-f Copy in all files except those in patterns. Use only with the -i 
option. 

-b Reverses the order of the bytes within each word. Use only 
with the -i option. 

Examples 

The first example below copies the contents of a directory into an ( 
archive; the second duplicates a directory hierarchy: 

Is I cpio -o >/dev/fdO 

cd olddir 

find . -print I cpio -pdl newdir 

Or: 

find . -print I cpio -oB >/dev/rfdO 

See Also 

ar(CP), find(C), cpio(F) 

Notes 

Pathnames are restricted to 128 characters. If there are too many ( 
unique linked files, the program runs out of memory to keep track of 
them and thereafter linking information is lost. Only the super-user 
can copy special files. 
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Name 

cron - Executes commands at specified times. 



Syntax 

/etc/cron 
crontab [file] 
crontab -r 
crontab -1 



Description 

cron is the clock daemon that executes commands at specified dates 
and times according to the instructions in the files located in 
/usr/spool/cron/crontabs. Regularly scheduled commands can be 
specified according to instructions found in crontab files; users can 
submit their own crontab file via the crontab command. Commands 
which are to be executed only once may be submitted via the at com- 
mand. Because cron never exits, it should be executed only once. 
This is best done by running cron from the initialization process 
through the file /etc/rc. 

crontab copies the specified file, or standard input if no file is speci- 
fied, into a directory that holds all users' crontabs. The crontab file in 
the crontabs directory is given the user's login name. The — r option 
removes a user's crontab from the crontab directory, crontab — 1 will 
list the crontab file for the invoking user. 

A user is permitted to use crontab if their name appears in the file 
/usr/lib/cron/cron.allow. If that file does not exist, the file 
/usr/lib/cron/cron.deny is checked to determine if the user should be 
denied access to crontab. If neither file exists, only root is allowed to 
submit a job. Global usage is permitted by the existence of an empty 
cron.deny file, cron.deny is checked only if cron.allow does not 
exist. The allow/deny files consist of one user name per line. 

The crontabs files consist of lines of six fields each. The fields are 
separated by spaces or tabs. The first five are integer patterns that 
specify the minute (0-59), hour (0-23), day of the month (1-31), month 
of the year (1-12), and day of the week (0-6, with 0=Sunday). Each of 
these patterns may contain: 

- A number in the (respective) range indicated above 

- Two numbers separated by a minus (indicating an inclusive range) 
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- A list of numbers separated by commas (meaning all of these 
numbers) 

- An asterisk (meaning all legal values) 

Note that the specification of days may be made by two fields (day of 
the month and day of the week). If both are specified as a list of ele- 
ments, both are adhered to. For example, 1,15 * 1 would run a 
command on the first and fifteenth of each month, as well as on every 
Monday. To specify days by only one field, the other field should be 
set to * (for example, 0**1 would run a command only on Mon- 
days). 

The sixth field is a string that is executed by the shell at the specified 
time(s). A % in this field is translated into a newline character. Only 
the first line (up to a % or end-of-line) of the command field is exe- 
cuted by the shell. The other lines are made available to the command 
as standard input. 

The shell is invoked from your $HOME directory with an argO of sh. 
Users who desire to have their .profile executed must explicitly do so 
in the crontab file, cron supplies a default environment for every 
shell, defining HOME, LOGNAME, SHELL ( =/bin/sh ), and 
PATH ( =:/bin:/usi7bin:/usi7lbin ). 

cron examines the crontabs directory periodically to see if it has 
changed; if it has, cron reads it. Thus it takes only a short while for 
entries to become effective. 

crontab exits and returns a value of 55 if it cannot allocate enough 
memory. If it exits for any other reason, it returns a value of 1 . 



Examples 

An example crontabs file follows: 

30 4 * * * /etc/sa -s > /dev/null 

4 * * * calendar - 

15 4 * * * find Aisr/preserve -mtime +7 -a -exec rm -f { } ; 

30 4 1 1 1 /usrAib/uucp/uuclean 

40 4 * * * find / -name '#*' -atime +3 -exec rm -f { } ; 

1,21,41**** (echo -n ' '; date; echo ) >/dev/console 

A history of all actions by cron can be recorded in /usr/lib/cron/log. 
This logging occurs only if the variable CRONLOG in 
/etc/default/cron is set to YES. By default this value is set to NO and 
no logging occurs. If logging should be turned on, be sure to monitor 
the size of /usr/lib/cron/log so that it doesn't unreasonably consume 
disk space. 
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Files 



/usr/lib/cron 



main cron directory 



/usr/spool/cron/crontabs/* 



spool area 



/usr/lib/cron/log 



accounting information 



/usr/lib/cron/cron.allow 



list of allowed users 



/usrAib/cron/cron.deny 



list of denied users 



/usr/lib/cron/.proto 



cron environment information 



/usrAib/cron/queuedefs 



cron data file 



/etc/default/cron 



cron logging default information 



See Also 

at(C), sh(C) 

Notes 

cron reads the files in the crontabs directory only when there is a 
change, but it reads the in-core version of the tables periodically. 

Users should remember to redirect the standard output and standard 
error of their commands, otherwise any generated output or errors will 
be mailed to the user. 

crontab will overwrite any previous entry with the same name. 
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Name 

csh - Invokes a shell command interpreter with C-like syntax. 



Syntax 

csh [ -cefinstvVxX ] [ arg ... ] 



Description 

csh is a command language interpreter. It begins by executing com- 
mands from the file .cshrc in the home directory of the invoker. If 
this is a login shell, it also executes commands from the file .login 
there. In the normal case, the shell begins reading commands from the 
terminal, prompting with % . Processing of arguments and the use of 
the shell to process files containing command scripts will be described 
later. 

The shell then repeatedly performs the following actions: a line of 
command input is read and broken into words. This sequence of words 
is placed on the command history list and then parsed. Finally, each 
command in the current line is executed. 

When a login shell terminates, it executes commands from the file 
.logout in the user's home directory. 

Lexical structure 

The shell splits input lines into words at blanks and tabs with the fol- 
lowing exceptions. The characters &, I, ;, <, >, (, ), form separate 
words. If doubled in &&, I I , «, or », these pairs form single words. 
These parser metacharacters may be made part of other words, or 
prevented their special meaning, by preceding them with \ A newline 
preceded by a \ is equivalent to a blank. 

In addition, strings enclosed in matched pairs of quotations, " or ", 
form parts of a word; metacharacters in these strings, including blanks 
and tabs, do not form separate words. These quotations have seman- 
tics to be described subsequently. Within pairs of \ or " characters, a 
newline preceded by a \ gives a true newline character. 

When the shell's input is not a terminal, the character # introduces a 
comment which continues to the end of the input line. It does not 
have this special meaning when preceded by \ and placed inside the 
quotation marks \ and ". 
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Commands 

A simple command is a sequence of words, the first of which specifies 
the command to be executed. A simple command or a sequence of 
simple commands separated by I characters forms a pipeline. The out- 
put of each command in a pipeline is connected to the input of the 
next. Sequences of pipelines may be separated by ;, and are then exe- 
cuted sequentially. A sequence of pipelines may be executed without 
waiting for it to terminate by following it with a &. Such a sequence 
is automatically prevented from being terminated by a hangup signal; 
the nohup command need not be used. 

Any of the above may be placed in parentheses to form a simple com- 
mand (which may be a component of a pipeline, etc.) It is also possi- 
ble to separate pipelines with I I or && indicating, as in the C 
language, that the second is to be executed only if the first fails or 
succeeds respectively. (See Expressions.) 

Substitutions 

The following sections describe the various transformations the shell 
performs on the input in the order in which they occur. 

History Substitutions 

History substitutions can be used to reintroduce sequences of words 
from previous commands, possibly performing modifications on these 
words. Thus, history substitutions provide a generalization of a redo 
function. 

History substitutions begin with the character ! and may begin any- 
where in the input stream if a history substitution is not already in 
progress. The ! may be preceded by a \ to prevent its special meaning; 
a ! is passed unchanged when it is followed by a blank, tab, newline, 
=, or (. History substitutions may also occur when an input line begins 
with This special abbreviation will be described later. 

Any input line which contains history substitution is echoed on the 
terminal before it is executed as it could have been entered without 
history substitution. 

Commands input from the terminal which consist of one or more 
words are saved on the history list, the size of which is controlled by 
the history variable. The previous command is always retained. Com- 
mands are numbered sequentially from 1. 
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For example, enter the command: 
history 

Now, consider the following output from the history command: 

9 write michael 

10 ex write.c 

1 1 cat oldwrite.c 

12 diff *write.c 

The commands are shown with their event numbers. It is not usually 
necessary to use event numbers, but the current event number can be 
made part of the prompt by placing a ! in the prompt string. 

With the current event 13 we can refer to previous events by event 
number 111, relatively as in 1-2 (referring to the same event), by a pre- 
fix of a command word as in Id for event 12 or !w for event 9, or by a 
string contained in a word in the command as in !?mic? also referring 
to event 9. These forms, without further modification, simply reintro- 
duce the words of the specified events, each separated by a single 
blank. As a special case I! refers to the previous command; thus I! 
alone is essentially a redo. The form !# references the current com- 
mand (the one being entered). It allows a word to be selected from 
further left in the line, to avoid retyping a long name, as in !#: 1 . 

To select words from an event, we can follow the event specification 
by a : and a designator for the desired words. The words of an input 
line are numbered from 0, the first (usually command) word being 0, 
the second word (first argument) being 1, and so on. The basic word 
designators are: 

First (command) word 

n nth argument 

First argument, i.e. 1 

$ Last argument 

% Word matched by (immediately preceding) ?s ? search 
x-y 

Range of words 
-y Abbreviates 0-y 

* Abbreviates "-$, or nothing if only 1 word in event 
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x * Abbreviates x -$ 

x - Like x * but omitting word $ 

The : separating the event specification from the word designator can 
be omitted if the argument selector begins with a ",$,*,- or %. After 
the optional word designator, a sequence of modifiers can be placed, 
each preceded by a :. The following modifiers are defined: 

h Removes a trailing pathname component 

r Removes a trailing .xxx component 

s///r/ 

Substitutes / for r 

t Removes all leading pathname components 

& Repeats the previous substitution 

g Applies the change globally, prefixing the above 

p Prints the new command but does not execute it 

q Quotes the substituted words, preventing substitutions 

x Like q, but breaks into words at blanks, tabs, and newlines 

Unless preceded by a g, the modification is applied only to the first 
modifiable word. In any case it is an error for no word to be applica- 
ble. 

The left sides of substitutions are not regular expressions in the sense 
of the editors, but rather strings. Any character may be used as the 
delimiter in place of /; a \ quotes the delimiter within the / and r 
strings. The character & in the right side is replaced by the text from 
the left. A \ quotes & also. A null / uses the previous string either 
from a / or from a contextual scan string s in !?s ?. The trailing delim- 
iter in the substitution may be omitted if a newline follows immedi- 
ately as may the trailing ? in a contextual scan. 

A history reference may be given without an event specification, e.g., 
!$. In this case the reference is to the previous command unless a pre- 
vious history reference occurred on the same line in which case this 
form repeats the previous reference. Thus !?foo?"!$ gives the first and 
last arguments from the command matching ?foo?. 

A special abbreviation of a history reference occurs when the first 
nonblank character of an input line is a This is equivalent to !:s", 
providing a convenient shorthand for substitutions on the text of the 
previous line. Thus Iblib fixes the spelling of lib in the previous 
command. Finally, a history substitution may be surrounded with { 
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and } if necessary to insulate it from the characters that follow. Thus, 
after Is -Id ~paul we might do !{l}a to do Is -Id "paula, while !la would 
look for a command starting la. 

Quotations With ' and " 

The quotation of strings by ' and " can be used to prevent all or some 
of the remaining substitutions. Strings enclosed in ' are prevented any 
further interpretation. Strings enclosed in " are variable and command 
expansion may occur. 

In both cases, the resulting text becomes (all or part of) a single word; 
only in one special case (see Command Substitution below) does a " 
quoted string yield parts of more than one word; ' quoted strings never 
do. 



Alias Substitution 

The shell maintains a list of aliases which can be established, 
displayed and modified by the alias and unalias commands. After a 
command line is scanned, it is parsed into distinct commands and the 
first word of each command, left-to-right, is checked to see if it has an 
alias. If it does, then the text which is the alias for that command is 
reread with the history mechanism available as though that command 
were the previous input line. The resulting words replace the com- 
mand and argument list. If no reference is made to the history list, 
then the argument list is left unchanged. 

Thus if the alias for Is is Is -1 the command "Is /usr" would map to "Is 
-1 /usr". Similarly if the alias for lookup was "grep\! A /etc/pass wd" 
then "lookup bill' ' would map to "grep bill /etc/passwd". 

If an alias is found, the word transformation of the input text is per- 
formed and the aliasing process begins again on the reformed input 
line. Looping is prevented if the first word of the new text is the same 
as the old by flagging it to prevent further aliasing. Other loops are 
detected and cause an error. 

Note that the mechanism allows aliases to introduce parser metasyn- 
tax. Thus we can alias print "'pr\!* I lpr'" to make a command that 
paginates its arguments to the lineprinter. 

There are four csh aliases distributed with the XENIX System V csh. 
These are pushd, popd, swapd, and flipd. These aliases maintain a 
directory stack. 

pushd dir 

Pushes the current directory onto the top of the directory stack, 
changes to the directory dir. 
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popd 

Changes to the directory at the top of the stack, then removes 
(pops) the top directory from the stack, and announces the current 
directory. 

swapd 

Swaps the top two directories on the stack. The directory on the 
top becomes the second to the top, and the second to the top direc- 
tory becomes the top directory. 

flipd 

Flips between two directories, the current directory and the top 
directory on the stack. If you are currently in dirl,and dir2 is on 
the top of the stack, when flipd is invoked, you change to dir2 and 
dirl is replaced as the top directory on the stack. When flipd is 
again invoked, you change to dirl and dir2 is again the top direc- 
tory on the stack. 



Variable Substitution 

The shell maintains a set of variables, each of which has a list of zero 
or more words as its value. Some of these variables are set by the 
shell or referred to by it. For instance, the argv variable is an image of 
the shell's argument list, and words of mis variable's value are 
referred to in special ways. 

The values of variables may be displayed and changed by using the set 
and unset commands. Of the variables referred to by the shell a 
number are toggles; the shell does not care what their value is, only 
whether they are set or not. For instance, the verbose variable is a tog- 
gle which causes command input to be echoed. The setting of this 
variable results from the -v command line option. 

Other operations treat variables numerically. The at-sign (@) com- 
mand permits numeric calculations to be performed and the result 
assigned to a variable. However, variable values are always 
represented as (zero or more) strings. For the purposes of numeric 
operations, the null string is considered to be zero, and the second and 
subsequent words of multiword values are ignored. 

After the input line is aliased and parsed, and before each command is 
executed, variable substitution is performed, keyed by dollar sign ($) 
characters. This expansion can be prevented by preceding the dollar 
sign with a backslash (\) except within double quotation marks (") 
where it always occurs, and within single quotation marks (') where it 
never occurs. Strings quoted by back quotation marks 0) are inter- 
preted later (see Command substitution below) so dollar sign substitu- 
tion does not occur there until later, if at all. A dollar sign is passed 
unchanged if followed by a blank, tab, or end-of-line. 
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Input and output redirections are recognized before variable expan- 
sion, and are variable expanded separately. Otherwise, the command 
name and entire argument list are expanded together. It is thus possi- 
ble for the first (command) word to generate more than one word, the 
first of which becomes the command name, and the rest of which 
become arguments. 

Unless enclosed in double quotation marks or given the :q modifier, 
the results of variable substitution may eventually be command and 
filename substituted. Within double quotation, marks (") a variable 
whose value consists of multiple words expands to a portion of a sin- 
gle word, with the words of the variable's value separated by blanks. 
When the :q modifier is applied to a substitution, the variable expands 
to multiple words with each word separated by a blank and quoted to 
prevent later command or filename substitution. 

The following sequences are provided for introducing variable values 
into the shell input. Except as noted, it is an error to reference a vari- 
able which is not set. 

$name 
${name} 

Are replaced by the words of the value of variable name, each 
separated by a blank. Braces insulate name from following 
characters which would otherwise be part of it. Shell variables 
have names consisting of up to 20 letters, digits, and under- 
scores. 

If name is not a shell variable, but is set in the environment, then that 
value is returned (but : modifiers and the other forms given below are 
not available in this case). 

$name [selector] 

${ name [selector]} 

May be used to select only some of the words from the value of 
name. The selector is subjected to $ substitution and may con- 
sist of a single number or two numbers separated by a -. The 
first word of a variables value is numbered 1. If the first number 
of a range is omitted it defaults to 1. If the last member of a 
range is omitted it defaults to $#name. The selector * selects all 
words. It is not an error for a range to be empty if the second 
argument is omitted or in range. 

$#name 
${#name} 

Gives the number of words in the variable. This is useful for 
later use in a [selector]. 

$0 Substitutes the name of the file from which command input is being 
read. An error occurs if the name is not known. 
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$number 
${ number} 

Equivalent to $argv[number]. 

$* Equivalent to $argv[*]. 

The modifiers :h, :t, :r, :q and :x may be applied to the substitutions 
above as may :gh, :gt and :gr. If braces { } appear in the command 
form then the modifiers must appear within the braces. Only one : 
modifier is allowed on each $ expansion. 

The following substitutions may not be modified with : modifiers. 

$?name 
${?name} 

Substitutes the string 1 if name is set, if it is not. 
$?0 Substitutes 1 if the current input filename is known, if it is not. 
$$ Substitutes the (decimal) process number of the (parent) shell. 
Command and Filename Substitution 

Command and filename substitution are applied selectively to the 
arguments of built-in commands. This means that portions of expres- 
sions which are not evaluated are not subjected to these expansions. 
For commands which are not internal to the shell, the command name 
is substituted separately from the argument list. This occurs very late, 
after input-output redirection is performed, and in a child of the main 
shell. 

Command Substitution 

Command substitution is indicated by a command enclosed in back 
quotation marks. The output from such a command is normally bro- 
ken into separate words at blanks, tabs and newlines, with null words 
being discarded, this text then replacing the original string. Within 
double quotation marks, only newlines force new words; blanks and 
tabs are preserved. 

In any case, the single final newline does not force a new word. Note 
that it is possible for a command substitution to yield only part of a 
word, even if the command outputs a complete line. 



Filename Substitution 

If a word contains any of the characters *, ?, [ or { or begins with the 
character ~, then that word is a candidate for filename substitution, 
also known as globbing. This word is then regarded as a pattern, and 
replaced with an alphabetically sorted list of filenames which match 
the pattern. In a list of words specifying filename substitution it is an 
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error for no pattern to match an existing filename, but it is not required 
for each pattern to match. Only the metacharacters *, ?, and [ imply 
pattern matching, the characters ~ and { being more akin to abbrevia- 
tions. 

In matching filenames, the character . at the beginning of a filename or 
immediately following a /, as well as the character / must be matched 
explicitly. The character * matches any string of characters, including 
the null string. The character ? matches any single character. The 
sequence within square brackets [] matches any one of the characters 
enclosed. Within square brackets [], a pair of characters separated by 
- matches any character lexically between the two. 

The character ~ at the beginning of a filename is used to refer to home 
directories. Standing alone, it expands to the invoker's home directory 
as reflected in the value of the variable home. When followed by a 
name consisting of letters, digits and - characters the shell searches for 
a user with that name and substitutes their home directory; thus "ken 
might expand to /usr/ken and ~ken/chmach to /usr/ken/chmach. If the 
character ~ is followed by a character other than a letter or / or appears 
not at the beginning of a word, it is left unchanged. 

The metanotation a{b,c,d}e is a shorthand for abe ace ade. Left to 
right order is preserved, with results of matches being sorted 
separately at a low level to preserve this order. This construct may be 
nested. Thus ~source/sl/{oldls,ls}.c expands to /usr/source/sl/oldls.c 
/usr/source/slAs.c, whether or not these files exist, assuming that the 
home directory for source is /usr/source. Similarly ../{memo,*box} 
might expand to ../memo ../box ../mbox. (Note that memo was not 
sorted with the results of matching *box.) As a special case { , } and 
{ } are passed unchanged. 



Spelling Checker 

Just as with the Bourne shell, when using cd(C) the shell checks spel- 
ling. For example, if you change to a different directory using cd and 
misspell the directory name, the shell responds with an alternative 
spelling of an existing directory. Enter "y" and press RETURN (or 
just press RETURN) to change to the offered directory. If the offered 
spelling is incorrect, enter "n", then retype the command line. In this 
example the csh(C) response is boldfaced: 

% cd /usr/spol/uucp 

/usr/spooI/uucp?y 

ok 
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Input/Output 

The standard input and standard output of a command may be 
redirected with the following syntax: 

< name 

Opens file name (which is first variable, command and filename 
expanded) as the standard input. 

« word 

Reads the shell input up to a line which is identical to word. 
Word is not subjected to variable, filename or command substi- 
tution, and each input line is compared to word before any sub- 
stitutions are done on this input line. Unless a quoting 
backslash, double, or single quotation mark, or a back quotation 
mark appears in word, variable and command substitution is 
performed on the intervening lines, allowing \ to quote $, \ and \ 
Commands which are substituted have all blanks, tabs, and new- 
lines preserved, except for the final newline which is dropped. 
The resulting text is placed in an anonymous temporary file 
which is given to the command as standard input. 

> name 
>! name 
>& name 
>&! name 

The file name is used as standard output. If the file does not 
exist, then it is created; if the file exists, it is truncated, and its 
previous contents are lost. 

If the variable noclobber is set, then the file must not already 
exist or it must be a character special file (e.g., a terminal or 
/dev/null) or an error results. This helps prevent accidental des- 
truction of files. In this case, the ! forms can be used and 
suppress this check. 

The forms involving & route the diagnostic output into the 
specified file as well as the standard output. Name is expanded 
in the same way as < input filenames are. 

» name 
»& name 
»! name 
»&! name 

Uses file name as standard output like > but places output at the 
end of the file. If the variable noclobber is set, then it is an error 
for the file not to exist unless one of the ! forms is given. Other- 
wise similar to >. 

If a command is run detached (followed by &) then the default stan- 
dard input for the command is the empty file /dev/null. Otherwise, the 
command receives the environment in which the shell was invoked as 
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modified by the input-output parameters and the presence of the com- 
mand in a pipeline. Thus, unlike some previous shells, commands run 
from a file of shell commands have no access to the text of the com- 
mands by default; rather they receive the original standard input of the 
shell. The « mechanism should be used to present inline data. This 
permits shell command scripts to function as components of pipelines 
and allows the shell to block read its input. 

Diagnostic output may be directed through a pipe with the standard 
output. Simply use the form I & rather than just I. 

Expressions 

A number of the built-in commands (to be described later) take 
expressions, in which the operators are similar to those of C, with the 
same precedence. These expressions appear in the @, exit, if, and 
while commands. The following operators are available: 

I I && I "&==!=<=>=<> « » 
+ -*/%!"() 

Here the precedence increases to the right, == and !=, <=, >=, <, and 
>, « and », + and -, * / and % being, in groups, at the same level. 
The == and != operators compare their arguments as strings, all others 
operate on numbers. Strings which begin with are considered octal 
numbers. Null or missing arguments are considered 0. The result of 
all expressions are strings, which represent decimal numbers. It is 
important to note that no two components of an expression can appear 
in the same word; except when adjacent to components of expressions 
which are syntactically significant to the parser (&!<>()) they 
should be surrounded by spaces. 

Also available in expressions as primitive operands are command exe- 
cutions enclosed in { and } and file enquiries of the form -/ name 
where / is one of: 



r 


Read access 


w 


Write access 


X 


Execute access 


e 


Existence 





Ownership 


z 


Zero size 


f 


Plain file 


d 


Directory 



The specified name is command and filename expanded, then tested to 
see if it has the specified relationship to the real user. If the file does 
not exist or is inaccessible then all enquiries return false, i.e. 0. Com- 
mand executions succeed, returning true, i.e. 1, if the command exits 
with status 0, otherwise they fail, returning false, i.e. 0. If more 
detailed status information is required then the command should be 
executed outside of an expression and the variable status examined. 
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Control Flow 

The shell contains a number of commands which can be used to regu- 
late the flow of control in command files (shell scripts) and (in limited 
but useful ways) from terminal input. These commands all operate by 
forcing the shell to reread or skip in its input and, due to the imple- 
mentation, restrict the placement of some of the commands. 

The for each, switch, and while statements, as well as the if -then-else 
form of the if statement require that the major keywords appear in a 
single simple command on an input line as shown below. 

If the shell's input is not seekable, the shell buffers up input whenever 
a loop is being read and performs seeks in this internal buffer to 
accomplish the rereading implied by the loop. (To the extent that this 
allows, backward goto commands will succeed on nonseekable 
inputs.) 

Built-in Commands 

Built-in commands are executed within the shell. If a built-in com- 
mand occurs as any component of a pipeline except the last, then it is 
executed in a subshell. 

alias 

alias name 

alias name wordlist 

The first form prints all aliases. The second form prints the alias 
for name . The final form assigns the specified wordlist as the 
alias of name; wordlist is command and filename substituted. 
Name is not allowed to be alias or unalias 

break 

Causes execution to resume after the end of the nearest enclos- 
ing foreach or while statement. The remaining commands on 
the current line are executed. Multilevel breaks are thus possi- 
ble by writing them all on one line. 

breaksw 

Causes a break from a switch, resuming after the endsw. 
case label: 

A label in a switch statement as discussed below. 

cd 

cd name 
chdir 

chdir name 

Changes the shell's working directory to directory name. If no 
argument is given, it then changes to the home directory of the 
user. If name is not found as a subdirectory of the current direc- 
tory (and does not begin with /, ./, or ../), then each component of 
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the variable cdpath is checked to see if it has a subdirectory 
name. Finally, if all else fails but name is a shell variable 
whose value begins with /, then this is tried to see if it is a direc- 
tory. 

continue 

Continues execution of the nearest enclosing while or for each. 
The rest of the commands on the current line are executed. 

default: 

Labels the default case in a switch statement. The default 
should come after all case labels. 

echo wordlist 

The specified words are written to the shell's standard output. A 
\c causes the echo to complete without printing a newline. A\n 
in wordlist causes a newline to be printed. Otherwise the words 
are echoed, separated by spaces. 

else 
end 
endif 
endsw 

See the description of the for each, if, switch, and while state- 
ments below. 

exec command 

The specified command is executed in place of the current shell. 

exit 

exit(expr) 

The shell exits either with the value of the status variable (first 
form) or with the value of the specified expr (second form). 

foreach name (wordlist) 

end 

The variable name is successively set to each member of 
wordlist and the sequence of commands between this command 
and the matching end are executed. (Both foreach and end must 
appear alone on separate lines.) 

The built-in command continue may be used to continue the 
loop prematurely and the built-in command break to terminate it 
prematurely. When this command is read from the terminal, the 
loop is read up once prompting with ? before any statements in 
the loop are executed. 

glob wordlist 

Like echo but no \ escapes are recognized and words are delim- 
ited by null characters in the output. Useful for programs which 
wish to use the shell to filename expand a list of words. 
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goto word 

The specified word is filename and command expanded to yield 
a string of the form label. The shell rewinds its input as much as 
possible and searches for a line of the form label: possibly pre- 
ceded by blanks or tabs. Execution continues after the specified 
line. 

history 

Displays the history event list. 

if (expr) command 

If the specified expression evaluates true, then the single com- 
mand with arguments is executed. Variable substitution on 
command happens early, at the same time it does for the rest of 
the if command. Command must be a simple command, not a 
pipeline, a command list, or a parenthesized command list. 
Input/output redirection occurs even if expr is false, when com- 
mand is not executed. 

if (expr) then 

else if (expr2) then 

else 

endif 

If the specified expr is true then the commands to the first else 
are executed; else if exprl is true then the commands to the 
second else are executed, etc. Any number of else-if pairs are 
possible; only one endif is needed. The else part is likewise 
optional. (The words else and endif must appear at the begin- 
ning of input lines; the if must appear alone on its input line or 
after an else.) 

logout 

Terminates a login shell. The only way to log out if ignoreeof is 
set. 

nice 

nice +number 

nice command 

nice +number command 

The first form sets the nice for this shell to 4. By default, com- 
mands run under C-Shell have a "nice value" of 0. The second 
form sets the nice to the given number. The final two forms run 
command at priority 4 and number respectively. The super-user 
may specify negative niceness by using "nice -number The i 
command is always executed in a subshell, and the restrictions 
placed on commands in simple statements apply. 
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nohup 

nohup command 

The first form can be used in shell scripts to cause hangups to be 
ignored for the remainder of the script. The second form causes 
the specified command to be run with hangups ignored. Unless 
the shell is running detached, nohup has no effect. All processes 
detached with & are automatically nohuped. (Thus, nohup is 
not really needed.) 

onintr 
onintr - 
onintr label 

Controls the action of the shell on interrupts. The first form 
restores the default action of the shell on interrupts which is to 
terminate shell scripts or to return to the terminal command 
input level. The second form onintr - causes all interrupts to be 
ignored. The final form causes the shell to execute a goto label 
when an interrupt is received or a child process terminates 
because it was interrupted. 

In any case, if the shell is running detached and interrupts are 
being ignored, all forms of onintr have no meaning and inter- 
rupts continue to be ignored by the shell and all invoked com- 
mands. 

rehash 

Causes the internal hash table of the contents of the directories 
in the path variable to be recomputed. This is needed if new 
commands are added to directories in the path while you are 
logged in. This should only be necessary if you add commands 
to one of your own directories, or if a systems programmer 
changes the contents of one of the system directories. 

repeat count command 

The specified command which is subject to the same restrictions 
as the command in the one line if statement above, is executed 
count times. I/O redirection occurs exactly once, even if count 
is 0. 

set 

set name 

set name=word 

set name [index] = word 

set name=(wordlist) 

The first form of the command shows the value of all shell vari- 
ables. Variables which have other than a single word as value 
print as a parenthesized word list. The second form sets name to 
the null string. The third form sets name to the single word. The 
fourth form sets the indexth component of name to word; this 
component must already exist. The final form sets name to the 
list of words in wordlist. In all cases the value is command and 
filename expanded. 
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These arguments may be repeated to set multiple values in a 
single set command. Note however, that variable expansion 
happens for all arguments before any setting occurs. 

setenv name value 

Sets the value of the environment variable name to be value, a 
single string. Useful environment variables are TERM, the type 
of your terminal and SHELL, the shell you are using. 

shift 

shift variable 

The members of argv are shifted to the left, discarding argvfl]. 
It is an error for argv not to be set or to have less than one word 
as value. The second form performs the same function on the 
specified variable. 

source name 

The shell reads commands from name. Source commands may 
be nested; if they are nested too deeply, the shell may run out of 
file descriptors. An error in a source at any level terminates all 
nested source commands. Input during source commands is 
never placed on the history list. 

switch (string) 
case strl: 

breaksw 

default: 

breaksw 
endsw 

Each case label is successively matched, against the specified 
string which is first command and filename expanded. The file 
metacharacters *, ?, and [...] may be used in the case labels, 
which are variable expanded. If none of the labels match before 
a default label is found, then the execution begins after the 
default label. Each case label and the default label must appear 
at the beginning of a line. The command breaksw causes execu- 
tion to continue after the endsw. Otherwise control may fall 
through case labels and default labels, as in C. If no label 
matches and there is no default, execution continues after the 
endsw. 

time 

time command 

With no argument, a summary of time used by this shell and its 
children is printed. If arguments are given, the specified simple 
command is timed and a time summary as described under the 
time variable is printed. If necessary, an extra shell is created to 
print the time statistic when the command completes. 
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umask 
umask value 

The file creation mask is displayed (first form) or set to the 
specified value (second form). The mask is given in octal. 
Common values for the mask are 002 giving all access to the 
group and read and execute access to others, or 022 giving all 
access except no write access for users in the group or others. 

unalias pattern 

All aliases whose names match the specified pattern are dis- 
carded. Thus, all aliases are removed by unalias *. It is not an 
error for nothing to be unaliased. 

unhash 

Use of the internal hash table to speed location of executed pro- 
grams is disabled. 

unset pattern 

All variables whose names match the specified pattern are 
removed. Thus, all variables are removed by unset *; this has 
noticeably distasteful side-effects. It is not an error for nothing 
to be unset. 

wait 

All child processes are waited for. If the shell is interactive, 
then an interrupt can disrupt the wait, at which time the shell 
prints names and process numbers of all children known to be 
outstanding. 

while (expr) 

end 

While the specified expression evaluates nonzero, the com- 
mands between the while and the matching end are evaluated. 
Break and continue may be used to terminate or continue the 
loop prematurely. (The while and end must appear alone on 
their input lines.) Prompting occurs here the first time through 
the loop as for the for each statement if the input is a terminal. 

@ 

@ name = expr 

@ name [index] = expr 

The first form prints the values of all the shell variables. The 
second form sets the specified name to the value of expr. If the 
expression contains <, >, & or I then at least this part of the 
expression must be placed within ( ). The third form assigns the 
value of expr to the indexth argument of name. Both name and 
its indexth component must already exist. 

The operators *=, +=, etc. are available as in C. The space 
separating the name from the assignment operator is optional. 
Spaces are mandatory in separating components of expr which 
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would otherwise be single words. 

Special postfix ++ and ~ operators increment and decrement 
name respectively, i.e. @ i++. 

Predefined Variables 

The following variables have special meaning to the shell. Of these, 
argv, child, home, path, prompt, shell and status are always set by the 
shell. Except for child and status this setting occurs only at initializa - 
tion; these variables will not be modified unless done explicitly by the 
user. 

The shell copies the environment variable PATH into the variable 
path, and copies the value back into the environment whenever path is 
set. Thus is is not necessary to worry about its setting other than in the 
file .cshrc as inferior csh processes will import the definition of path 
from the environment. 



argv 

cdpath 
child 

echo 



histchars 



history 



Set to the arguments to the shell, it is from this vari- 
able that positional parameters are substituted, i.e., 
$1 is replaced by $argv[l], etc. 

Gives a list of alternate directories searched to find 
subdirectories in cd commands. 

The process number printed when the last command 
was forked with &. This variable is unset v/hen this 
process terminates. 

Set when the -x command line option is given. 
Causes each command and its arguments to be 
echoed just before it is executed. For nonbuilt-in 
commands all expansions occur before echoing. 
Builtin commands are echoed before command and 
filename substitution, since these substitutions are 
then done selectively. 

Can be assigned a two-character string. The first 
character is used as a history character in place of !, 
the second character is used in place of the * substi- 
tution mechanism. For example, set histchars=",;" 
will cause the history characters to be comma and 
semicolon. 

Can be given a numeric value to control the size of 
the history list. Any command which has been 
referenced in this many events will not be dis- 
carded. A history that is too large may run the shell 
out of memory. The last executed command is 
always saved on the history list. 
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mail 



noclobber 

noglob 

nonomatch 

path 

) 
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The home directory of the invoker, initialized from 
the environment. The filename expansion of 
refers to this variable. 

If set, the shell ignores end-of-file from input dev- 
ices that are terminals. This prevents a shell from 
accidentally being terminated by pressing Ctrl-D. 

The files where the shell checks for mail. This is 
done after each command completion which will 
result in a prompt, if a specified interval has 
elapsed. The shell responds with, "You have new 
mail" if the file exists with an access time not 
greater than its modify time. 

If the first word of the value of mail is numeric, it 
specifies a different mail checking interval: in 
seconds, rather than the default, which is 10 
minutes. 

If multiple mail files are specified, then the shell 
responds with "New mail in name", when there is 
mail in the file name. 

As described in the section Input/Output, restric- 
tions are placed on output redirection to insure that 
files are not accidentally destroyed, and that » 
redirections refer to existing files. 

If set, filename expansion is inhibited. This is most 
useful in shell scripts which are not dealing with 
filenames, or after a list of filenames has been 
obtained and further expansions are not desirable. 

If set, it is not an error for a filename expansion to 
not match any existing files; rather, the primitive 
pattern is returned. It is still an error for the primi- 
tive pattern to be malformed, i.e., echo [ still gives 
an error. 

Each word of the path variable specifies a directory 
in which commands are to be sought for execution. 
A null word specifies the current directory. If there 
is no path variable, then only full pathnames will 
execute. The usual search path is /bin, /usr/bin, and 
., but this may vary from system to system. For the 
super-user, the default search path is /etc, /bin and 
/usr/bin. A shell which is given neither the -c nor 
the -t option will normally hash the contents of the 
directories in the path variable after reading .cshrc, 
and each time the path variable is reset. If new 
commands are added to these directories while the 
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shell is active, it may be necessary to give the 
rehash command, or the commands may not be 
found. 

prompt The string which is printed before each command is 

read from an interactive terminal input. If a ! 
appears in the string, it will be replaced by the 
current event number unless a preceding \ is given. 
Default is % , or # for the super-user. 

shell The file in which the shell resides. This is used in 

forking shells to interpret files which have execute 
bits set, but which are not executable by the system. 
(See the description of Nonbuilt-In Command Exe- 
cution below.) Initialized to the (system- 
dependent) home of the shell. 

status The status returned by the last command. If it ter- 

minated abnormally, then 0200 is added to the 
status. Built-in commands which fail return exit 
status 1, all other built-in commands set status 0. 

time Controls automatic timing of commands. If set, 

then any command which takes more than this 
many cpu seconds will cause a line giving user, sys- 
tem, real time, and a utilization percentage which is 
the ratio of user plus system times to real time to be 
printed when it terminates. 

verbose Set by the -v command line option, causes the 

words of each command to be printed after history 
substitution. 



Nonbuilt-In Command Execution 

When a command to be executed is found to not be a built-in com- 
mand, the shell attempts to execute the command via exec(S). Each 
word in the variable path names a directory from which the shell will 
attempt to execute the command. If it is given neither a -c nor a -t 
option, the shell will hash the names in these directories into an inter- 
nal table so that it will only try an exec in a directory if there is a pos- 
sibility that the command resides there. This greatly speeds command 
location when a large number of directories are present in the search 
path. If this mechanism has been turned off (via unhash), or if the 
shell was given a -c or -t argument, and in any case for each directory 
component of path which does not begin with a /, the shell concaten- 
ates with the given command name to form a pathname of a file which 
it then attempts to execute. 
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Parenthesized commands are always executed in a subshell. Thus (cd 
; pwd) ; pwd prints the home directory; leaving you where you were 
(printing this after the home directory), while cd ; pwd leaves you in 
the home directory. Parenthesized commands are most often used to 
prevent cd from affecting the current shell. 

If the file has execute permissions but is not an executable binary to 
the system, then it is assumed to be a file containing shell commands 
and a new shell is spawned to read it. 

If there is an alias for shell then the words of the alias are prepended 
to the argument list to form the shell command. The first word of the 
alias should be the full pathname of the shell (e.g. $shell). Note that 
this is a special, late occurring, case of alias substitution, and only 
allows words to be prepended to the argument list without 
modification. 

Argument List Processing 

If argument to the shell is - then this is a login shell. The flag argu- 
ments are interpreted as follows: 

-c Commands are read from the (single) following argument which 
must be present. Any remaining arguments are placed in argv. 

-e The shell exits if any invoked command terminates abnormally 
or yields a nonzero exit status. 

-f The shell will start faster, because it will neither search for nor 
execute commands from the file .cshrc in the invoker's home 
directory. 

-i The shell is interactive and prompts for its top-level input, even 
if it appears to not be a terminal. Shells are interactive without 
this option if their input and output are terminals. 

-n Commands are parsed, but not executed. This may aid in syn- 
tactic checking of shell scripts. 

-s Command input is taken from the standard input. 

-t A single line of input is read and executed. A \ may be used to 
escape the newline at the end of this line and continue onto 
another line. 

-v Causes the verbose variable to be set, with the effect that com- 
mand input is echoed after history substitution. 

-x Causes the echo variable to be set, so that commands are echoed 
immediately before execution. 
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-V Causes the verbose variable to be set even before .cshrc is exe- 
cuted. 

-X Causes the echo variable to be set even before .cshrc is exe- 
cuted. 

After processing of flag arguments, if arguments remain but none of 
the -c, -i, -s, or -t options were given, the first argument is taken as the 
name of a file of commands to be executed. The shell opens this file, 
and saves its name for possible resubstitution by $0. On a typical sys- 
tem, most shell scripts are written for the standard shell (see sh(C)), 
the C shell will execute such a standard shell if the first character of a 
script is not a # (i.e. if the script does not start with a comment). 
Remaining arguments initialize the variable argv. 

Signal Handling 

The shell normally ignores quit signals. The interrupt and quit signals 
are ignored for an invoked command if the command is followed by 
&; otherwise the signals have the values which the shell inherited 
from its parent. The shells handling of interrupts can be controlled by 
onintr. Login shells catch the terminate signal; otherwise this signal is 
passed on to children from the state in the shell's parent. In no case 
are interrupts allowed when a login shell is reading the file .logout. 



Files 



"/.cshrc 


Read at by each shell at the beginning 




of execution 


/etc/cshrc 


Systemwide default cshrc file if none is present 


"/.login 


Read by login shell, after .cshrc at login 


"/.logout 


Read by login shell, at logout 


/bin/sh 


Shell for scripts not starting with a # 


/tmp/sh* 


Temporary file for « 


/dev/null 


Source of empty file 


/etc/passwd 


Source of home directories for "name 



Limitations 

Words can be no longer than 512 characters. The number of argu- 
ments to a command which involves filename expansion is limited to 
1/6 number of characters allowed in an argument list, which is 5120, 
less the characters in the environment. Also, command substitutions 
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may substitute no more characters than are allowed in an argument 
list. 

To detect looping, the shell restricts the number of alias substitutions 
on a single line to 20. 



See Also 

access(S), exec(S), fork(S), pipe(S), signal(S), umask(S), wait(S), 
a.out(F), environ(M) 



Credit 

This utility was developed at the University of California at Berkeley 
and is used with permission. 



Notes 

Built-in control structure commands like foreach and while cannot be 
used with I , & or ;. 

Commands within loops, prompted for by ?, are not placed in the his- 
tory list. 

It is not possible to use the colon (:) modifiers on the output of com- 
mand substitutions. 

The C-shell has many built-in commands with the same name and 
functionality as Bourne shell commands. However, the syntax of 
these C-shell and Bourne shell commands often differs. One example 
is the nice command, another is the echo command. Be sure to use the 
correct syntax when working with these built-in C-shell commands. 

When a C-shell user logs in, the system reads and executes commands 
in letclcshrc before executing commands in the user's $HOMEI.cshrc. 
You can, therefore, modify the C-shell environment for all users on the 
system by editing letclcshrc. 

During intervals of heavy system load, pressing the delete key while 
at a C-shell prompt ( % ) may cause the shell to exit. If csh is the login 
shell, the user is logged out. 

csh attempts to import and export the PATH variable for use with reg- 
ular shell scripts. This only works for simple cases, where the PATH 
contains no command characters. 

This version of csh does not support or use the process control features 
of the 4th Berkeley Distribution. 
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Name 

csplit - Splits files according to context. 



Syntax 

csplit [-s] [-k] [-f prefix] file argl [. . . argn] 



Description 

csplit reads file and separates it into n+1 sections, defined by the 
arguments argl . . . argn. By default the sections are placed in xxOO 
. . . xxn (n may not be greater than 99). These sections get the fol- 
lowing pieces of/i'/e : * 

00: From the start of file up to (but not including) the line refer- 
enced by argl . 

01: From the line referenced by argl up to the line referenced by 
argl. 



n+1 : From the line referenced by argn to the end of file . 
The options to csplit are: 

-s csplit normally prints the character counts for each file 

created. If the -s option is present, csplit suppresses the 
printing of all character counts. 

-k csplit normally removes created files if an error occurs. If 
the -k option is present, csplit leaves previously created files 
intact. 

-f prefix If the -f option is used, the created files are named prefixOO 
. . . prefixn. The default is xxOO . . . xxn. 

The arguments (argl . . . argn) to csplit can be a combination of the 
following: 

Irexpl A file is to be created for the section from the current line up 
to (but not including) the line containing the regular expres- 
sion rexp. The current line becomes the line containing 
rexp . This argument may be followed by an optional +or - 
some number of lines (e.g., /Page/-5). 

%rexp% This argument is the same as Irexpl, except that no file is 
created for the section. 
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Inno A file is to be created from the current line up to (but not 
including) Inno. The current line becomes Inno. 

{num} Repeat argument. This argument may follow any of the 
above arguments. If it follows a rexp type argument, that 
argument is applied num more times. If it follows Inno , the 
file will be split every Inno lines (num times) from that 
point. 

Enclose all rexp type arguments that contain blanks or other charac- 
ters meaningful to the shell in the appropriate quotation marks. Regu- 
lar expressions may not contain embedded newlines. c split does not 
affect the original file; it is the users responsibility to remove it. 



Examples 

csplit -f cobol file '/procedure division/' /par5./ /pari 6./ 

This example creates four files, cobolOO . . . cobol()3. After editing 
the "split" files, they can be recombined as follows: 

cat cobol0[0-3] > file 

Note that this example overwrites the original file. 

csplit -k file 100 {99} 

This example would split the file at every 100 lines, up to 10,000 lines. 
The -k option causes the created files to be retained if there are less 
than 10,000 lines; however, an error message would still be printed. 

csplit -k prog.c '%main(%' T}/+1' {20} 

Assuming that prog.c follows the normal C coding convention of end- 
ing routines with a } at the beginning of the line, this example will 
create a file containing each separate C routine (up to 21) in prog.c. 



See Also 

ed(C), sh(C), regex(S) 
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Diagnostics 

Self-explanatory except for: 
arg - out of range 

which means that the given argument did not reference a line between 
the current position and the end of the file. 
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Name 

ct - spawn getty to a remote terminal 



Syntax 

ct [ -wn ] [ -xn ] [ -h ] [ -v ] [ -sspeed ] telno ... 



Description 

ct dials the telephone number of a modem that is attached to a termi- 
nal, and spawns a getty process to that terminal. Telno is a telephone 
number, with equal signs for secondary dial tones and minus signs for 
delays at appropriate places. (The set of legal characters for telno is 
thru 9, -, =, *, and #. The maximum length telno is 58 characters). If 
more than one telephone number is specified, ct will try each in suc- 
cession until one answers; this is useful for specifying alternate dial- 
ing paths. 

ct will try each ACU line listed in the file /usr/lib/uucp/Devices until 
it finds an available line with appropriate attributes or runs out of 
entries. If there are no free lines, ct will ask if it should wait for one, 
and if so, for how many minutes it should wait before it gives up. ct 
will continue to try to open the dialers at one-minute intervals until 
the specified limit is exceeded. The dialogue may be overridden by 
specifying the -wn option, where n is the maximum number of 
minutes that ct is to wait for a line. 

The -xn option is used for debugging; it produces a detailed output of 
the program execution on stderr. The debugging level, n, is a single 
digit; -x9 is the most useful value. If the -v option is used, ct will 
send a running narrative to the standard error output stream. 

Normally, ct will hang up the current line, so the line can answer the 
incoming call. The -h option will prevent this action. The -h option 
will also wait for the termination of the specified ct process before 
returning control to the user's terminal. 

The data rate may be set with the -s option, where speed is expressed 
in baud. The default rate is 1200. 

After the user on the destination terminal logs out, ct prompts, Recon- 
nect? If the response does not begin with the letter y, the line will be 
dropped; otherwise, getty will be started again and the login: prompt 
will be printed. 

To log out properly, the user must type control D. 



June 29, 1988 



Page 1 



CI (C) 



CT(C) 



Of course, the destination terminal must be attached to a modem that 
can answer the telephone. 



Files 

/usr/lib/uucp/Devices 
/usr/lib/uucp/LCK. .(tty-device) 
/usr/adm/ctlog 



See Also 

cu(C), login(M), uucp(C), getty(M). 



Notes 

In hangup mode (-h not specified), when a suitable dialer has been 
allocated, ct prompts "Proceed to hang-up?" If the response does not 
begin with the letter y, the program simply exits. If you are logged in 
on a computer through a local terminal and you want to connect a 
remote terminal to the computer, you should use nohup with ct to 
accomplish this: 

nohup ct -h -sspeed phone 

After the command is executed, a login prompt is displayed on the 
remote terminal. The user can then log in and work on the computer 
just as on a local terminal. 
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Name 

cu - call another XENIX/UNIX system 



Syntax 

cu [ -sspeed ] [ -lline ] [ -h ] [ -t ] [ -xn ] [ -o I -e I -oe ] [ -n ] telno 
cu [ -s speed ] [ -h ] [ -xn ] [ [ -o I -e I -oe ] -1 line [ dir ] 
cu [ -h ] [ -xn ] [ -o I -e I -oe ] systemname 



Description 

cu calls up another UNIX system, a terminal, or possibly a non-UNIX 
system. It manages an interactive conversation with possible transfers 
of ASCII files. 

cu accepts the following options and arguments: 

-sspeed Specifies the transmission speed (150, 300, 600, 1200, 
2400, 4800, 9600, 19200, 38400); The default value is 
"Any" speed which will depend on the order of the lines 
in the /usr/Iib/uucp/Devices file. Or a speed range may 
be specified (for example, -sl200-4800). 

-lline Specifies a device name to use as the communication 

line. This can be used to override the search that would 
otherwise take place for the first available line having 
the right speed. When the -1 option is used without the 
-s option, the speed of a line is taken from the Devices 
file. When the -I and -s options are both used together, 
cu will search the Devices file to check if the requested 
speed for the requested line is available. If so, the con- 
nection will be made at the requested speed; otherwise 
an error message will be printed and the call will not be 
made. The specified device is generally a directly con- 
nected asynchronous line (e.g., /dey/ttyab) in which 
case a telephone number (telno) is not required. The 
specified device need. not be in the /dev directory. If 
the specified device is associated with an auto dialer, a 
telephone number must be provided. Use of this option 
with systemname rather than telno will not give the 
desired result (see systemname below). 

-h Emulates local echo, supporting calls to other computer 

systems which expect terminals to be set to half-duplex 
mode. 

-t Used to dial an ASCII terminal which has been set to 

auto answer. Appropriate mapping of carriage-return to 
carriage-return-line-feed pairs is set. 
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-xn Causes diagnostic traces to be printed; it produces a 

detailed output of the program execution on stderr. The 
debugging level, n, is a single digit; -x9 is the most 
useful value. 

-n For added security, will prompt the user to provide the 

telephone number to be dialed rather than taking it 
from the command line. 

telno When using an automatic dialer, the argument is the 

telephone number with equal signs for secondary dial 
tone or minus signs placed appropriately for delays of 4 
seconds. 

systemname A uucp system name may be used rather than a tele- 
phone number; in this case, cu will obtain an appropri- 
ate direct line or telephone number from - 
/usr/lib/uucp/Systems. Note: the systemname option 
should not be used in conjunction with the -1 and -s 
options as cu will connect to the first available line for 
the system name specified, ignoring the requested line 
and speed. 

dir The keyword dir can be used with cu -Mine, in order to 

talk directly to a modem on that line, instead of talking 
to another system via that modem; this can be useful 
when debugging or checking modem operation. Note: 
only users with write access to the Devices file are per- 
mitted to use cu -Mine dir . 

In addition, cu uses the following options to determine communica- 
tions settings: 

-o If the remote system expects or sends 7-bit with odd parity, 
-e If the remote system expects or sends 7-bit with even parity, 
-oe 

If the remote system expects or sends 7-bit, ignoring parity and 
sends 7-bit with either parity. 

By default, cu expects and sends 8-bit characters without parity. If the 
login prompt received appears to contain incorrect 8-bit characters, or 
a correct login is rejected, use the 7-bit options described above. 

After making the connection, cu runs as two processes: the transmit 
process reads data from the standard input and, except for lines begin- 
ning with passes it to the remote system; the receive process accepts 
data from the remote system and, except for lines beginning with 
passes it to the standard output. Normally, an automatic DC3/DC1 
protocol is used to control input from the remote so the buffer is not 
overrun. Lines beginning with " have special meanings. 
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The transmit process interprets the following user initiated com- 
mands: 



terminate the conversation. 



"! escape to an interactive shell on the local sys- 

tem. 

"Icmd . . . run cmd on the local system (via sh -c). 

"%cmd . . . run cmd locally and send its output to the 

remote system. 

"%cd change the directory on the local system. 

Note: "!cd will cause the command to be run 
by a sub-shell, probably not what was 
intended. 



%take from [ to ] copy file from (on the remote system) to file 
to on the local system. If to is omitted, the 
from argument is used in both places. 

%put from [ to ] copy file from (on local system) to file to on 
remote system. If to is omitted, the from 
argument is used in both places. 

For both ~%take and put commands, as each 
block of the file is transferred, consecutive 
single digits are printed to the terminal. 



line 
'% break 

'% debug 



send the line " line to the remote system. 

transmit a BREAK to the remote system 
(which can also be specified as ~%b). 

toggles the -x debugging level between and 
9 (which can also be specified as "%d). 

prints the values of the termio structure vari- 
ables for the user's terminal (useful for 
debugging). 

prints the values of the termio structure vari- 
ables for the remote communication line 
(useful for debugging). 



%nostop toggles between DC3/DC1 input control pro- 

tocol and no input control. This is useful in 
case the remote system is one which does not 
respond properly to the DC3 and DC1 charac- 
ters. 
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The receive process normally copies data from the remote system to 
its standard output. Internally the program accomplishes this by ini- 
tiating an output diversion to a file when a line from the remote begins 
with " 

Data from the remote is diverted (or appended, if » is used) to file on 
the local system. The trailing "> marks the end of the diversion. 

The use of "%put requires stty(C) and cat(C) on the remote side. It 
also requires that the current erase and kill characters on the remote 
system be identical to these current control characters on the local 
system. Backslashes are inserted at appropriate places. 

The use of "%take requires the existence of echo(S) and cat(C) on the 
remote system. Also, tabs mode (See stty(C)) should be set on the 
remote system if tabs are to be copied without expansion to spaces. 

When cu is used on system X to connect to system Y and subsequently 
used on system Y to connect to system Z, commands on system Y can 
be executed by using ~~. Executing a tilde command reminds the user 
of the local system uname. For example, uname can be executed on Z, 
X, and Y as follows: 

uname 
Z 

~[X] ! uname 
X 

~~[Y]! uname 
Y 

In general, " causes the command to be executed on the original 
machine, causes the command to be executed on the next machine 
in the chain. 



Examples 

To dial a system whose telephone number is 9 201 555 1212 using 
1200 baud (where It 1 1 is expected after the 9): 

cu -sl200 9=12015551212 
If the speed is not specified, "Any" is the default value. 
To login to a system connected by a direct line: 

cu -1 /dev/ttyXX 

or 

cu -1 ttyXX 
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To dial a system with the specific line and a specific speed: 

cu -sl200 -1 ttyXX 
To dial a system using a specific line associated with an auto dialer: 

cu -1 ttyXX 9=12015551212 
To use a system name: 

cu systemname 
To talk directly to an ACU: 

cu -lttyXXdir 



Files 

/usr/lib/uucp/Systems 
/usr/lib/uucp/Devices 
/usr/lib/uucp/LCK. . (tty-device) 



See Also 

cat(C), ct(C), echo(S), stty(C), uucp(C), uname(C). 



Diagnostics 

Exit code is zero for normal exit, otherwise, one. 



Warnings 

The cu command does not do any integrity checking on data it 
transfers. Data fields with special cu characters may not be transmit- 
ted properly. Depending on the interconnection hardware, it may be 
necessary to use a ". to terminate the conversion even if stty has 
been used. Non-printing characters are not dependably transmitted 
using either the "%put or "%take commands, cu between an IMBR1 
and a penril modem will not return a login prompt immediately upon 
connection. A carriage return will return the prompt. 



Notes 

There is an artificial slowing of transmission by cu during the "%put 
operation so that loss of data is unlikely. 
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Name 

date - Prints and sets the date. 



Syntax 

date [ mmddhhmm [y y ] ] [ +format ] 



Description 

If no argument is given, or if the argument begins with +, the current 
date and time are printed. Otherwise, the current date is set. The first 
mm is the month number; dd is the day number in the month; hh is the 
hour number (24-hour system); the second mm is the minute number; 
yy is the last 2 digits of the year number and is optional. For example: 

date 10080045 

sets the date to Oct 8, 12:45 AM. The current year is the default if no 
year is mentioned. The system operates in GMT. date takes care of 
the conversion to and from local standard and daylight time. 

If the argument begins with +, the output of date is under the control 
of the user. The format for the output is similar to that of the first 
argument to printf(S). All output fields are of fixed size (zero padded 
if necessary). Each field descriptor is preceded by a percent sign (%) 
and will be replaced in the output by its corresponding value. A single 
percent sign is encoded by doubling the percent sign, i.e., by specify- 
ing All other characters are copied to the output without 
change. The string is always terminated with a newline character. 

Field Descriptors: 



n 


Inserts a newline character 


t 


Inserts a tab character 


m 


Month of year - 01 to 12 


d 


Day of month -01 to 31 


y 


Last 2 digits of year - 00 to 99 


D 


Date as mm/dd/yy 


H 


Hour - 00 to 23 


M 


Minute - 00 to 59 
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S Second - 00 to 59 

T Time as HH:MM:SS 

j Julian date - 001 to 366 

w Day of the week - Sunday = 

a Abbreviated weekday - Sun to Sat 

h Abbreviated month - Jan to Dec 

r Time in AM/PM notation 

Example 

The line 

date '+DATE: %m/%d/%y%nTIME: %H:%M:%S' 

generates as output: 

DATE: 08/01/76 
TIME: 14:45:05 

Diagnostics 

no permission You aren't the super-user and you are trying to 

change the date. 

bad conversion The date set is syntactically incorrect. 

bad format character The field descriptor is not recognizable. 
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Name 

dc - Invokes an arbitrary precision calculator. 



Syntax 

dc [ file ] 



Description 

dc is an arbitrary precision arithmetic package. Ordinarily it operates 
on decimal integers, but you may specify an input base, output base, 
and a number of fractional digits to be maintained. The overall struc- 
ture of dc is a stacking (reverse Polish) calculator. If an argument is 
given, input is taken from that file until its end, then from the standard 
input. The following constructions are recognized: 

number 

The value of the number is pushed on the stack. A number is 
an unbroken string of the digits 0-9. It may be preceded by an 
underscore (_) to input a negative number. Numbers may con- 
tain decimal points. 

+ - / * % A 

The top two values on the stack are added (+), subtracted (-), 
multiplied (*), divided (/), remaindered (%), or exponentiated 
Q. The two entries are popped off the stack; the result is 
pushed on the stack in their place. Any fractional part of an 
exponent is ignored. 

sx The top of the stack is popped and stored into a register named 
x, where x may be any character. If the s is capitalized, x is 
treated as a stack and the value is pushed on it. 

be The value in register x is pushed on the stack. The register x is 
not altered. All registers start with zero value. If the 1 is capi- 
talized, register x is treated as a stack and its top value is 
popped onto the main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack , is printed. The top value remains 
unchanged, p interprets the top of the stack as an ASCII string, 
removes it, and prints it. 

f All values on the stack are printed. 

q Exits the program. If executing a string, the recursion level is 
popped by two. If q is capitalized, the top value on the stack is 
popped and the string execution level is popped by that value. 
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x Treats the top element of the stack as a character string and 
executes it as a string of dc commands. 

X Replaces the number on the top of the stack with its scale fac- 
tor. 

[ ... ] Puts the bracketed ASCII string onto the top of the stack. 
<x >x =x 

The top two elements of the stack are popped and compared. 
Register x is evaluated if they obey the stated relation. 

v Replaces the top element on the stack by its square root. Any 
existing fractional part of the argument is taken into account, 
but otherwise the scale factor is ignored. 

! Interprets the rest of the line as a XENIX command. 

c All values on the stack are popped. 

i The top value on the stack is popped and used as the number 
radix for further input. 

I Pushes the input base on the top of the stack. 

o The top value on the stack is popped and used as the number 
radix for further output. 

O Pushes the output base on the top of the stack. 

k The top of the stack is popped, and that value is used as a non- 
negative scale factor; the appropriate number of places are 
printed on output, and maintained during multiplication, divi- 
sion, and exponentiation. The interaction of scale factor, input 
base, and output base will be reasonable if all are changed 
together. 

z The stack level is pushed onto the stack. 

Z Replaces the number on the top of the stack with its length. 

? A line of input is taken from the input source (usually the ter- 
minal) and executed. 

; : Used by be for array operations. 



Example 

This example prints the first ten values of n! : 
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[la 1 +dsa *pla 1 0>y] sy 

Osal 

lyx 



See Also 

bc(C) 



Diagnostics 

x is unimplemented 

stack empty 

Out of space 
Out of headers 
Out of pushdown 
Nesting Depth 



The octal number x corresponds to a character 
that is not implemented as a command 

Not enough elements on the stack to do what 
was asked 

The free list is exhausted (too many digits) 
Too many numbers being kept around 
Too many items on the stack 
Too many levels of nested execution 



Notes 



be is a preprocessor for dc, providing infix notation and a C-like syn- 
tax which implements functions and reasonable control structures for 
programs. For interactive use, be is preferred to dc . 
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Name 

dd - Converts and copies a file. 

Syntax 

dd [option= value] ... 

Description 

dd copies the specified input file to the specified output with possible 
conversions. The standard input and output are used by default. The 
input and output block size may be specified to take advantage of raw 



physical I/O. 

Option Value 

ii=file Input filename; standard input is default 

of=file Output filename; standard output is default 

ibs=« Input block size n bytes (default is BSIZE block size) 

obs=n Output block size (default is BSIZE block size) 

bs=« Sets both input and output block size, superseding ibs 

and obs; also, if no conversion is specified, it is par- 
ticularly efficient since no in-core copy needs to be 
done 

cbs=« Conversion buffer size 

skip=n Skips n input records before starting copy 

seek=n Seeks n records from beginning of output file before 
copying 

count=« Copies only n input records 

conv=ascii Converts EBCDIC to ASCII 

conv=ebcdic Converts ASCII to EBCDIC 

conv=ibm Slightly different map of ASCII to EBCDIC 

conv=lcase Maps alphabetics to lowercase 
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Option 
conv=ucase 
conv=swab 
conv=sync 
conv=" 



Value 

Maps alphabetics to uppercase 
Swaps every pair of bytes 
Pads every input record to ibs 

Several comma-separated conversions 



Where sizes are specified, a number of bytes is expected. A number 
may end with k, b, or w to specify multiplication by 1024, 512, or 2 
respectively; a pair of numbers may be separated by x to indicate a 
product. 

Cbs is used only if ascii or ebcdic conversion is specified. In the 
former case cbs characters are placed into the conversion buffer, con- 
verted to ASCII, and trailing blanks trimmed and newline added before 
sending the line to the output. In the latter case ASCII characters are 
read into the conversion buffer, converted to EBCDIC, and blanks 
added to make up an output record of size cbs . 

After completion, dd reports the number of whole and partial input 
and output blocks. 



Examples 

This command reads an EBCDIC tape, blocked ten 80-byte EBCDIC 
card images per record, into the ASCII file outfile : 

dd if=/dev/rmtO of=outfile ibs=800 cbs=80 conv=ascii,lcase 

Note the use of raw magtape, dd is especially suited to I/O on raw 
physical devices because it allows reading and writing in arbitrary 
record sizes. 



See Also 

copy(C), cp(C), tar(C) 



Diagnostics 

f+p records in(out) Numbers of full and partial records 

read(written) 
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Notes 

The ASCII/EBCDIC conversion tables are taken from the 256- 
character standard in the CACM Nov, 1968. The ibm conversion 
corresponds better to certain IBM print train conventions. There is no 
universal solution. 

Newlines are inserted only on conversion to ASCII; padding is done 
only on conversion to EBCDIC. 

When using dd with a raw device, specify the block size as a multiple 
of IK. For example, to use a 9K block size, enter: 

dd if=file of=/dev/rfdO bs=18b 

You could also enter: 

dd if=file of=/dev/rfdO bs=9K 
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Name 

devnm - Identifies device name. 



DEVNM (C) 



Syntax 

/etc/devnm [ names ] 

Description 

Devnm identifies the special file associated with the mounted file sys- 
tem where the argument name resides. 

This command is most commonly used by /etc/rc to construct a mount 
table entry for the root device. 

Examples 

Be sure to type full pathnames in this example: 

/etc/devnm /usr 
If /dev/hdl is mounted on /usr, this produces: 

hdl /usr 

Files 

/dev/* Device names 

/etc/rc Xenix startup commands 

See Also 

setmnt(ADM) 
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Name 

df - Report number of free disk blocks. 



Syntax 

df [ -t ] [ -f ] [ -v -i ] [ file-systems ] 



Description 

df prints out the number of free blocks and free inodes available for 
on-line file systems by examining the counts kept in the super-blocks; 
file -systems may be specified by device name (e.g., /dev/root). If the 
file -systems argument is unspecified, the free space on all of the 
mounted file systems is sent to the standard output. The list of 
mounted file systems is given in /etc/mnttab. 

Options include: 

-t Causes total allocated block figures to be reported as well as 
number of free blocks. 

-f Reports only an actual count of the blocks in the free list (free 
inodes are not reported). With this option, df reports on raw 
devices. 

-v Reports the percent of blocks used as well as the number of 
blocks used and free. 

-i Reports the percent of inodes used as well as the number of 
inodes used and free. Use the -i option with the -v option to 
display counts of blocks and inodes free as well as the percen- 
tage of inodes and blocks used. 

The -v and -i options can not be used with other d/ options. 



Files 

/dev/* 
/etc/mnttab 



See Also 

mount(ADM), fsck(ADM), mnttab(F) 



May 16, 1988 



Page 1 



DF(C) 



DF(C) 



Notes 



See Notes under mount(ADM). 

This utility reports sizes in 512 byte blocks. On systems which use 
1024 byte blocks, this means a file of 500 bytes uses 2 blocks, df will 
report 2 blocks less free space, rather than 1 block, since the file uses 
one system block of 1024 bytes. Refer to the machine(HW) manual 
page for the block size used by your system. 



May 16, 1988 



Page 2 



DIFF (C) 



DIFF (C) 



Name 

diff - Compares two text files. 



Syntax 

diff [ -efbh ] filel file2 



Description 

diff tells what lines must be changed in two files to bring them into 
agreement. If filel ox filel is a dash (-), the standard input is used. If 
filel or file2 is a directory, diffuses, the file in that directory that has 
the same name as file (file2 or filel respectively) it is compared to. 
For example: 

diff Itmp dog 

compares the file named dog, that is in the Itmp directory, with the file 
dog in the current directory. The normal output contains lines of these 
forms: 

nl a n3,n4 
nl,n2 d n3 
nl,n2 c n3,n4 

These lines resemble ed commands to convert filel into file2 . The 
numbers after the letters pertain to file2 . In fact, by exchanging a for 
d and reading backward, one may ascertain equally how to convert 
file2 into filel . As in ed, identical pairs where nl = n2 or nS - n4 are 
abbreviated as a single number. 

Following each of these lines come all the lines that are affected in the 
first file flagged by <, then all the lines that are affected in the second 
file flagged by >. 

The -b option causes trailing blanks (spaces and tabs) to be ignored 
and other strings of blanks" to compare equal. 

The -e option produces a script of a, c and d commands for the editor 
ed, which will recreate file2 from filel . The -f option produces a simi- 
lar script, not useful with ed, in the opposite order. In connection with 
-e, the following shell procedure helps maintain multiple versions of a 
file: 

(shift; cat $*; echo 'l,$p') I ed - $1 

This works by performing a set of editing operations on an original 
ancestral file. This is done by combining the sequence of ed scripts 
given as all command line arguments except the first. These scripts 
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are presumed to have been created with diff in the order given on the 
command line. The set of editing operations is then piped as an edit- 
ing script to ed where all editing operations are performed on the 
ancestral file given as the first argument on the command line. The 
final version of the file is then printed on the standard output. Only an 
ancestral file ($1) and a chain of version-to-version ed scripts 
($2,$3,...) made by diffused be on hand. 

Except in rare circumstances, diff finds the smallest sufficient set of 
file differences. 

The -h option does a fast, less-rigorous job. It works only when 
changed stretches are short and well separated, but also works on files 
of unlimited length. The -e and -f cannot be used with the -h option. 

Files 

/tmp/d????? 
/usr/lib/diffh for -h 



See Also 

cmp(C), comm(C), ed(C) 



Diagnostics 

Exit status is for no differences, 1 for some differences, 2 for errors. 



Notes 

Editing scripts produced under the -e or -f option do not always work 
correctly on lines consisting of a single period (.). 
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Name 

diff3 - Compares three files. 



Syntax 

diff3 [ -ex3 ] filel file2 file3 



Description 

diff3 compares three versions of a file, and publishes disagreeing 
ranges of text flagged with these codes: 

==== All three files differ 

====1 Filel is different 

====2 Filel is different 

====3 File3 is different 

The type of change suffered in converting a given range of a given file 
to some other range is indicated in one of these ways: 

/ : nl a Text is to be appended after line number nl in 

file/, where / = 1, 2, or 3. 

/ : nl ,n2 c Text is to be changed in the range line nl to 

line ri2. If nl = nl, the range may be abbrevi- 
ated to nl . 

The original contents of the range follows immediately after a c indi- 
cation. When the contents of two files are identical, the contents of 
the lower-numbered file is suppressed. 

Under the -e option, diff3 publishes a script for the editor ed that will 
incorporate into filel all changes between file2 and file3 , i.e., the 
changes that normally would be flagged ==== and ====3. The -x 
option produces a script to incorporate changes flagged with "====". 
Similarly, the -3 option produces a script to incorporate changes 
flagged with "====3". The following command applies a resulting 
editing script to filel : 

(cat script; echo 'l,$p') I ed - filel 
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Files 

/tmp/d3* 
/usr/lib/difDprog 

See Also 

diff(C) 

Notes 

The -e option does not work properly for lines consisting of a single 
period. 

The input file size limit is 64K bytes. 
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Name 

dircmp - Compares directories. 
Syntax 

dircmp [ -d ] [ -s ] [ -w« ] dirl dir2 
Description 

dircmp examines dirl and dirl and generates tabulated information 
about the contents of the directories. Listings of files that are unique 
to each directory are generated in addition to a list that indicates 
whether the files common to both directories have the same contents. 

There are three options available: 

-d Performs a full diff on each pair of like-named files if the 
contents of the files are not identical. 

-s Suppresses output of identical filenames. 

-ww Changes the width of the output line to n characters. The 
default width is 72. 

See Also 

cmp(C), diff(C). 
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Name 

dirname - Delivers directory part of pathname. 

Syntax 

dirname string 

Description 

dirname delivers all but the last component of the pathname in string 
and prints the result on the standard output. If there is only one com- 
ponent in the pathname, only a "dot" is printed. It is normally used 
inside substitution marks ( N v ) within shell procedures. 

The companion command basename deletes any prefix ending in a 
slash (/) and the suffix (if present in string) from string, and prints the 
result on the standard output. 

Examples 

The following example sets the shell variable NAME to /usr/src/cmd: 

NAME= v dirname /usr/src/cmd/cat.c v 
This example prints /a/b/c on the standard output: 

dirname /a/b/c/d 
This example prints a "dot" on the standard output: 

dirname file.ext 

See Also 

basename(C), sh(C) 
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Name 

disable - Hirns off terminals and printers. 



Syntax 

disable tty ... 

disable [-c][-r [reason]] printers 



Description 

For terminals, this program manipulates the /etc/ttys file and signals 
init to disallow logins on a particular terminal. For printers, disable 
stops print requests from being sent to the named printer. The follow- 
ing options can be used: 

-c Cancels any requests that are currently printing. 

-r[reason] Associates a reason with disabling the printer. The rea- 
son applies to all printers listed up to the next -r option. 
If the -r option is not present or the -r option is given 
without a reason, then a default reason is used. Reason 
is reported by lpstat(C). 



Examples 

In this example, a printer named linepr is disabled because of a paper 
jam: 

disable -r"paper jam" linepr 



Files 

/dev/tty* 

/etc/ttys 

/usr/spool/lp/* 



See Also 

login(M), enable(C), ttys(F), getty(M), init(M), lp(C), lpinit(ADM), 
lpstat(C), ungetty(M) 
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Name 

diskcp, diskcmp - Copies, compares floppy disks. 



Syntax 

diskcp [ -f ] [ -d ] [ -s ] [ -48ds9 ] [ -96ds9 ] [ -96dsl5 ] [ -135ds9 ] [ -135dsl8 ] 
diskcmp [ -d ] [ -s ] [ -48ds9 ] [ -96ds9 ] [ -96dsl5 ] [ -135ds9 ] [ -135dsl8 ] 



Description 

diskcp is used to make an image (exact copy) of a source floppy disk 
on a target floppy disk. On machines with one floppy drive diskcp 
temporarily transfers the image to the hard disk until a blank "target' ' 
floppy is inserted into the floppy drive. On machines with two floppy 
drives diskcp immediately places the image of the source floppy 
directly on the target floppy. 

The options are: 

-f Format the target floppy disk before the image is copied (diskcp 
only). 

-d The computer has dual floppy drives, diskcp copies the image 
directly onto the target floppy. 

-s Uses sum(C) to compare the contents of the source and target 
floppies; gives an error message if the two do not match. 

-48ds9 

This setting is for low density 48tpi floppies. It is the default set- 
ting. 

-96ds9 

This setting is for high density 96tpi floppies. 
-96dsl5 

This setting is for quad density 96tpi floppies. 
-135ds9 

This setting is for high density 135tpi 3.5 inch floppies. 
-135dsl8 

This setting is for quad density 135tpi 3.5 inch floppies. 
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When using the -96ds9 and -96dsl5 options of diskcp, if the first tar- 
get disk is unformatted, the program will note it, format it and make 
the copy. If another copy is requested and another unformatted target 
disk inserted, diskcp exits with a "System Error." Quit, format the 
floppy , and reinvoke diskcp to make another copy. 

diskcmp functions similarly to diskcp . It compares the contents of one 
floppy disk with the contents of a second floppy disk using the cmp 
utility. 



Examples 

To make a copy of a floppy, place the source floppy in the drive and 
type: 

diskcp 

When diskcp is finished copying to the hard disk, it prompts you to 
insert the target floppy in the drive. If you specify the -f flag when you 
invoke diskcp , the program formats the target floppy. When 
the copy is finished, diskcp prompts if you would like to make another 
copy of the same source disk. If you enter 'n', it prompts if you would 
like to copy another source disk. 

Specify the -d flag on the command line if you have two floppy drives: 
diskcp -d 



Notes 

If diskcp encounters a write error while copying the source image to 
the target disk, it formats the disk and tries to write the source image 
again. This happens most often when an unformatted floppy is used 
and the -f flag is not specified. 



Files 

/usr/bin/diskcp 

/usr/bin/diskcmp 

/tmp/disk$$ 



See Also 

cmp(C), dd(C), sum(C) 
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Name 

dos, doscat, doscp, dosdir, dosformat, dosmkdir, dosls, dosrm, 
dosrmdir - Access to and manipulation of DOS files. 



Syntax 

doscat [ -r I -m ] file ... 
doscp [ -r I -m ] filel file2 
doscp [ -r I -m ] file ... directory 
dosdir directory ... 
dosformat [ -fqv ] drive 
dosls directory ... 
dosmkdir directory ... 
dosrm file ... 
dosrmdir directory ... 



Description 

The dos commands provide access to the files and directories on MS- 
DOS disks and on a DOS partition of a hard disk. Note that in order to 
use these commands on a DOS partition of a hard disk, the partition 
must be bootable, although not active. 

The dos commands perform the following actions: 

doscat Copies one or more DOS files to the standard output. If 

-r is given, the files are copied without newline conver- 
sions. If -m is given, the files are copied with newline 
conversions (see "Conversions" below). 

doscp Copies files between a DOS disk and a XENIX filesys- 

tem. If filel and filel are given, filel is copied to file2. 
If a directory is given, one or more files are copied to 
that directory. If -r is given, the files are copied 
without newline conversions. If -m is given, the files 
are copied with newline conversions (see "Conver- 
sions" below). 

dosdir Lists DOS files in the standard DOS style directory for- 

mat. 
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dosformat Creates a DOS 2.0 formatted diskette. The drive may 



be specified in either DOS drive convention, using the 
default file /etc/default/msdos, or using the XENIX spe- 
cial file name, dosformat cannot be used to format a 
hard disk. The -f option suppresses the interactive 
feature. The -q (quiet) option is used to suppress infor- 
mation normally displayed during dosformat . The -q 
option does not suppress the interactive feature. The -v 
option prompts the user for a volume label after the 
diskette has been formatted. The maximum size of the 
volume label is 1 1 characters. 



dosmkdir Creates a directory on a DOS disk. 

dosrmdir Deletes directories from a DOS disk. 

The file and directory arguments for DOS files and directories have the 
form: 

device:name 

where device is a XENIX pathname for the special device file contain- 
ing the DOS disk, and name is a pathname to a file or directory on the 
DOS disk. The two components are separated by a colon (:). For 
example, the argument: 

/dev/fdO:/src/file.asm 

specifies the DOS file, file.asm, in the directory, /src, on the disk in the 
device file /dev/fdO. Note that slashes (and not backslashes) are used 
as filename separators for DOS pathnames. Arguments without a dev- 
ice: are assumed to be XENIX files. 

For convenience, the user configurable default file, 
/etc/default/msdos, can define DOS drive names to be used in place of 
the special device file pathnames. It may contain the following lines: 

A=/dev/fd0 

C=/dev/hd0d 

D=/dev/hdld 

The drive letter "A" may be used in place of special device file path- 
name /dev/fdO when referencing DOS files (see "Examples" below). 
The drive letter "C" or "D" refer to the DOS partition on the first or 
second hard disk. 



dosls 



Lists DOS directories and files in a XEMX style (see 

HO). 



dosrm 



Removes files from a DOS disk. 
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The commands operate on the following kinds of disks: 

DOS partitions on a hard disk 
5 1/4 inch DOS 
3 1/2 inch DOS 

8, 9, 15, or 18 sectors per track 
40 tracks per side 
1 or 2 sides 

DOS versions 1.0, 2.0 or 3.0 



Conversions 

In the case of doscp, certain conversions are performed when copying 
a XENIX file. Filenames with a basename longer than eight characters 
are truncated. Filename extensions (the part of the name following 
separating period) longer than three characters are truncated. For 
example, the file 123456789.12345 becomes 12345678.123. A mes- 
sage informs the user that the name has been changed and the altered 
name is displayed. Filenames containing illegal DOS characters are 
stripped when writing to the MS-DOS format. A message informs the 
user that characters have been removed and displays the name as writ- 
ten. 

All DOS text files use a cairiage-return/linefeed combination, CR-LF , 
to indicate a newline. XENIX uses a single newline LF character. 
When the doscat and doscp commands transfer DOS text files to 
XENIX , they automatically strip the CR. When text files are 
transferred to DOS , the commands insert a CR before each LF charac- 
ter. 

Under some circumstances the automatic newline conversions do not 
occur. The -m option may be used to ensure the newline conversion. 
The -r option can be used to override the automatic conversion and 
force the command to perform a true byte copy regardless of file type. 



Examples 

doscat /dev/fdO:/docs/memo.txt 

doscat /tmp/f 1 /tmp/f2 /dev/fdO:/src/file.asm 

dosdir /dev/fdO:/src 
dosdir A:/src A:/dev 

doscp /tmp/myfile.txt /dev/fdO:/docs/memo.txt 
doscp /tmp/f 1 /tmp/f2 /dev/fdO:/mydir 

dosformat A: 
dosformat /dev/fdO 

dosls /dev/fdO:/src 
dosls B.- 
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dosmkdir /dev/fdO:/usr/docs 



dosrm /dev/fdO:/docs/memo.txt 
dosrm A:/docs/memol .txt 



dosrmdir /dev/fdO:/usr/docs 



Files 



/etc/default/msdos 



Default information 



/dev/fd* 



Floppy disk devices 



/dev/hd* 



Hard disk devices 



See Also 

assign(C), dtype(C) 



Notes 

It is not possible to refer to DOS directories with wild card 
specifications. The programs mentioned above cooperate among 
themselves so no two programs will access the same DOS disk. Only 
one process will access a given DOS disk at any time, while other 
processes wait. If a process has to wait too long, it displays the error 
message, "can't seize a device," and exits with an exit code of 1. 

The following hard disk devices: 

/dev/hdOd 
/dev/rhdOd 
/dev/hdld 
/dev/rhdld 

are similar to /dev/hdOa in that the disk driver determines which parti- 
tion is the DOS partition and uses that as hd?d. This means that 
software using the DOS partition does not need to know which parti- 
tion is DOS (the disk driver determines that). 

The XEMX Development System supports the creation of DOS exe- 
cutable files, using cc (CP). Refer to the XENIX C User's Guide and C 
Library Guide for more information on using XENIX to create pro- 
grams suitable for DOS systems. 

All of the DOS utilities leave temporary files in Itmp. These files are 
automatically removed when the system is rebooted. They can also be 
manually removed. 
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Name 

dtype - Determines disk type. 



Syntax 

dtype [-s] device ... 



Description 

dtype determines type of disk, prints pertinent information on the stan- 
dard output unless the silent (-s) option is selected, and exits with a 
corresponding code (see below). When more than one argument is 
given, the exit code corresponds to the last argument. 



Disk 


Exit 


Message 


Type 


Code 


(optional) 


Misc. 


60 


error (specified) 




61 


empty or unrecognized data 


Storage 


70 


dump format, volume n 




71 


tar format[, extent e of n] 




72 


cpio format 




73 


cpio character (-c) format 


MS-DOS 


80 


DOS 1 .x, 8 sec/track, single sided 




81 


DOS 1 .x, 8 sec/track, dual sided 




90 


DOS 2.x, 8 sec/track, single sided 




91 


DOS 2.x, 8 sec/track, dual sided 




92 


DOS 2.x, 9 sec/track, single sided 




93 


DOS 2.x, 9 sec/track, dual sided 




94 


DOS 2.x, fixed disk 




110 


DOS 3.x, 9 sec/track, dual sided 


XENIX 


120 


XENK 2.x filesystem [needs cleaning] 




130 


XENIX 3.x or later filesystem [needs cleaning] 



Notes 



word-swapped refers to byte ordering of long words in relation to the 
host system. 

XENIX file systems and dump and cpio binary formats may not be 
recognized if created on a foreign system. This is due to such system 
differences as byte and word swapping and structure alignment. 

This utility only works reliably for floppy diskettes. 
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Name 

du - Summarizes disk usage. 



Syntax 

du [ -afrsu ] [ names ] 



Description 

du gives the number of blocks contained in all files and (recursively) 
directories within each directory and file specified by the names argu- 
ment. The block count includes the indirect blocks of the file. If 
names is missing, the current directory is used. 

The optional argument -s causes only the grand total (for each of the 
specified names) to be given. The optional argument -a causes an 
entry to be generated for each file. Absence of either causes an entry 
to be generated for each directory only. 

The -f option causes du to display the usage of files in the current file 
system only. Directories containing mounted file systems will be 
ignored. The -u option causes du to ignore files that have more than 
one link. 

du is normally silent about directories that cannot be read, files that 
cannot be opened, etc. The -r option will cause du to generate mes- 
sages in such instances. 

A file with two or more links is only counted once. 



Notes 

If the -a option is not used, nondirectories given as arguments are not 
listed. 

If there are too many distinct linked files, du will count the excess 
files more than once. 

Files with holes in them will get an incorrect block count. 

This utility reports sizes in 512 byte blocks. Systems which define a 
block as 1024 characters, "round-off" the size of files containing 511 
or fewer bytes to 1 block, du interprets 1 block from a 1024 byte 
block system as 2 of its own 512 byte blocks. Thus a 500 byte file is 
interpreted as 2 blocks rather than 1. Refer to the machine(HW) 
manual page for the block size used by your system. 
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Name 

dump - Performs incremental file system backup. 
Syntax 

dump [ key [ arguments ] filesystem ] 
Description 

This command is identical to the backup utility. Refer to backup(C) 
for complete information. 
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Name 

dumpdir - Prints the names of files on a backup archive. 



Syntax 

dumpdir [ f filename ] 



Description 

dumpdir is used to list the names and inode numbers of all files and 
directories on an archive written with the backup command. This is 
most useful when attempting to determine the location of a particular 
file in a set of backup archives. 

The f option causes filename to be used as the name of the backup 
device instead of the default. The backup device depends on the set- 
ting of the variable TAPE in the file /etc/default/dumpdir. The dev- 
ice specified as TAPE can be any type of backup device supported by 
the system (for example, a floppy drive or cartridge tape drive). 



Files 

rst* Temporary files 



See Also 

backup(C), restore(C), default(F) 
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Name 

echo - Echoes arguments. 



Syntax 

echo [ arg ] ... 
/bin/echo [ arg ] ... 



Description 

echo writes its arguments separated by blanks and terminated by a 
newline on the standard output, echo also understands C-like escape 
conventions. The following escape sequences need to be quoted so 
that the shell interprets them correctly: 

\b Backspace 

\c Prints line without newline 

\f Form feed 

\n Newline 

\r Carriage return 

\t Tab 

\v Vertical tab 

\\ Backslash 

\n The 8-bit character whose ASCII code is a 1, 2 or 3-digit octal 
number. In all cases, n must start with a zero. For example: 

echo "\07" - Echoes Ctl-G. 

echo "\007 " - Also echoes Ctl-G. 

echo "\065" - Echoes the number "5". 

echo "\0065" - Also echoes the number "5". 

echo "\0101" - Echoes the letter "A". 

echo is useful for producing diagnostics in command files and for 
sending known data into a pipe. 

See Also 

sh(C) 
Notes 

The csh(C) has a built-in echo utility which has a different syntax than 
this echo . Be aware that users running under csh will get the built-in 
echo unless they specify /bin/echo . 
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Name 

ed - Invokes the text editor. 



Syntax 

ed [ - ] [ -p string ] [ file ] 



Description 

ed is the standard text editor. If the file argument is given, ed simu- 
lates an e command (see below) on the named file; that is to say, the 
file is read into ed's buffer so that it can be edited, ed operates on a 
copy of the file it is editing; changes made to the copy have no effect 
on the file until a w (write) command is given. The copy of the text 
being edited resides in a temporary file called the buffer. There is 
only one buffer. 

The options are: 

Suppresses the printing of character counts by the e, r, and w 
commands, of diagnostics from e and q commands, and the ! 
prompt after a \shell command. 

-p Allows the user to specify a prompt string. 

ed supports formatting capability. After including a format 
specification as the first line of file and invoking ed with your terminal 
in stty -tabs or stty tab3 mode (see sttyiC), the specified tab stops will 
automatically be used when scanning file. For example, if the first line 
of a file contained: 

<:t5,10,15 s72:> 

tab stops would be set at columns 5, 10, and 15, and a maximum line 
length of 72 would be imposed. NOTE: While inputting text, tab char- 
acters are expanded to every eighth column as the default. 

Commands to ed have a simple and regular structure: zero, one, or two 
addresses followed by a single-character command, possibly followed 
by parameters to that command. These addresses specify one or more 
lines in the buffer. Every command that requires addresses has default 
addresses, so that the addresses can very often be omitted. 
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In general, only one command may appear on a line. Certain com- 
mands allow the input of text. This text is placed in the appropriate 
place in the buffer. While ed is accepting text, it is said to be in input 
mode. In this mode, no commands are recognized; all input is merely 
collected. Input mode is left by entering a period (.) alone at the 
beginning of a line. 

ed supports a limited form of regular expression notation; regular 
expressions are used in addresses to specify lines and in some com- 
mands (e.g., s) to specify portions of a line that are to be substituted. 
A regular expression specifies a set of character strings. A member of 
this set of strings is said to be matched by the regular expression. The 
regular expressions allowed by ed are constructed as follows: 

The following one-character regular expressions match a single char- 
acter: 

1.1 An ordinary character {not one of those discussed in 1 .2 below) 
is a one-character regular expression that matches itself. 

1.2 A backslash (\) followed by any special character is a one- 
character regular expression that matches the special character 
itself. The special characters are: 

a. ., *, [, and \ (dot, star, left square bracket, and backslash, 
respectively), which are always special, except when they 
appear within square brackets ([]; see 1.4 below). 

b. ^ (caret), which is special at the beginning of an entire regu- 
lar expression (see 3.1 and 3.2 below), or when it immedi- 
ately follows the left of a pair of square brackets ([]) (see 
1.4 below). 

c. $ (dollar sign), which is special at the end of an entire regu- 
lar expression (see 3.2 below). 

d. The character used to bound (i.e., delimit) an entire regular 
expression, which is special for that regular expression (for 
example, see how slash (/) is used in the g command below). 

1.3 A period (.) is a one-character regular expression that matches 
any character except newline. 

1.4 A nonempty string of characters enclosed in square brackets ([ ]) 
is a one-character regular expression that matches any one char- 
acter in that string. If, however, the first character of the string is 
a caret ( A ), the one-character regular expression matches any 
character except newline and the remaining characters in the 
string. The star (*) has this special meaning only if it occurs first 
in the string. The dash (-) may be used to indicate a range of 
consecutive ASCII characters; for example, [0-9] is equivalent to 
[0123456789]. The dash (-) loses this special meaning if it 
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occurs first (after an initial caret ( A ), if any) or last in the string. 
The right square bracket (]) does not terminate such a string 
when it is the first character within it (after an initial caret ( A ), if 
any); e.g., []a-f] matches either a right square bracket (]) or one 
of the letters "a" through "f" inclusive. Dot, star, left bracket, 
and the backslash lose their special meaning within such a string 
of characters. 

The following rules may be used to construct regular expressions from 
one-character regular expressions: 

2.1 

A one-character regular expression followed by a star (*) is a regu- 
lar expression that matches zero or more occurrences of the one- 
character regular expression. If there is any choice, the longest 
leftmost string that permits a match is chosen. 

2.2 

A one-character regular expression followed by \{ra\}, \{m,\}, or 
\{m,n\} is a regular expression that matches a range of 
occurrences of the one-character regular expression. The values of 
m and n must be nonnegative integers less than 255; \{m\} 
matches exactly m occurrences; matches at least m 

occurrences; \{m,n\] matches any number of occurrences between 
m and n, inclusive. Whenever a choice exists, the regular expres- 
sion matches as many occurrences as possible. 

2.3 

The concatenation of regular expressions is a regular expression 
that matches the concatenation of the strings matched by each 
component of the regular expression. 

2.4 

A regular expression enclosed between the character sequences \( 
and \) is a regular expression that matches whatever the unadorned 
regular expression matches. See 2.6 below for a discussion of why 
this is useful. 

2.5 

The expression \n matches the same string of characters as was 
matched by an expression enclosed between \( and \) earlier in the 
same regular expression. Here n is a digit; the subexpression 
specified is that beginning with the n-th occurrence of \( counting 
from the left. For example, the expression ~\(.*\)\1$ matches a 
line consisting of two repeated appearances of the same string. 

Finally, an entire regular expression may be constrained to match 
only an initial segment or final segment of a line (or both): 

3.1 A caret ( A ) at the beginning of an entire regular expression con- 
strains that regular expression to match an initial segment of a 
line. 
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3.2 A dollar sign ($) at the end of an entire regular expression con- 
strains that regular expression to match a final segment of a line. 
The construction ~ entire regular expression % constrains the 
entire regular expression to match the entire line. 

The null regular expression (e.g., //) is equivalent to the last regular 
expression encountered. 

To understand addressing in ed , it is necessary to know that there is a 
current line at all times. Generally speaking, the current line is the last 
line affected by a command; the exact effect on the current line is dis- 
cussed under the description of each command. Addresses are con- 
structed as follows: 

1 . The character . addresses the current line. 

2. The character $ addresses the last line of the buffer. 

3. A decimal number n addresses the n-th line of the buffer. 

4. 'x addresses the line marked with the mark name character x, 
which must be a lowercase letter. Lines are marked with the k 
command described below. 

5. A regular expression enclosed by slashes (/) addresses the first 
line found by searching forward from the line following the 
current line toward the end of the buffer and stopping at the first 
line containing a string matching the regular expression. If 
necessary, the search wraps around to the beginning of the buffer 
and continues up to and including the current line, so that the 
entire buffer is searched. 

6. A regular expression enclosed in question marks (?) addresses 
the first line found by searching backward from the line preced- 
ing the current line toward the beginning of the buffer and stop- 
ping at the first line containing a string matching the regular 
expression. If necessary, the search wraps around to the end of 
the buffer and continues up to and including the current line. See 
also the last paragraph before Files below. 

7. An address followed by a plus sign (+) or a minus sign (-) fol- 
lowed by a decimal number specifies that address plus or minus 
the indicated number of lines. The plus sign may be omitted. 

8. If an address begins with + or -, the addition or subtraction is 
taken with respect to the current line; e.g, -5 is understood to 
mean .-5. 

9. If an address ends with + or -, then 1 is added to or subtracted 
from the address, respectively. As a consequence of this rule and 
of rule 8 immediately above, the address - refers to the line 
preceding the current line. (To maintain compatibility with 
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earlier versions of the editor, the character ~ in addresses is 
entirely equivalent to -.) Moreover, trailing + and - characters 
have a cumulative effect, so - refers to the current line less 2. 

10. For convenience, a comma (,) stands for the address pair 1,$, 
while a semicolon (;) stands for the pair .,$• 

Commands may require zero, one, or two addresses. Commands that 
require no addresses regard the presence of an address as an error. 
Commands that accept one or two addresses assume default addresses 
when an insufficient number of addresses is given; if more addresses 
are given than such a command requires, the last address(es) are used. 

Typically, addresses are separated from each other by a comma (,). 
They may also be separated by a semicolon (;). In the latter case, the 
current line (.) is set to the first address, and only then is the second 
address calculated. This feature can be used to determine the starting 
line for forward and backward searches (see rules 5 and 6 above). The 
second address of any two-address sequence must correspond to a line 
that follows, in the buffer, the line corresponding to the first address. 

In the following list of ed commands, the default addresses are shown 
in parentheses. The parentheses are not part of the address; they show 
that the given addresses are the default. 

It is generally illegal for more than one command to appear on a line. 
However, any command (except e,f, r, or w) may be suffixed by p or 
by 1, in which case the current line is either printed or listed, respec- 
tively, as discussed below under the p and / commands. 

(•)a 

<text> 

The append command reads the given text and appends it after the 
addressed line; dot is left at the last inserted line, or, if there were 
no inserted lines, at the addressed line. Address is legal for this 
command: it causes the "appended" text to be placed at the begin- 
ning of the buffer. 

(•)c 

<text> 

The change command deletes the addressed lines, then accepts 
input text that replaces these lines; dot is left at the last line input, 
or, if there were none, at the first line that was not deleted. 

(.,.)d 

The delete command deletes the addressed lines from the buffer. 
The line after the last line deleted becomes the current line; if the 
lines deleted were originally at the end of the buffer, the new last 
line becomes the current line. 
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The edit command causes the entire contents of the buffer to be 
deleted, and then the named file to be read in; dot is set to the last 
line of the buffer. If no filename is given, the currently remem- 
bered filename, if any, is used (see the / command). The number 
of characters read is typed; file is remembered for possible use as a 
default filename in subsequent e, r, and w commands. If file 
begins with an exclamation (!), the rest of the line is taken to be a 
shell command. The output of this command is read for the e and r 
commands. For the w command, the file is used as the standard 
input for the specified command. Such a shell command is not 
remembered as the current filename. 

Efile 

The .Edit command is like e, except the editor does not check to 
see if any changes have been made to the buffer since the last w 
command. 

ifile 

If file is given, the /ilename command changes the currently 
remembered filename to file; otherwise, it prints the currently 
remembered filename. 

( 1 , $ ^regular-expression I command list 

In the global command, the first step is to mark every line that 
matches the given regular expression. Then, for every such line, 
the given command list is executed with . initially set to that line. 
A single command or the first of a list of commands appears on the 
same line as the global command. All lines of a multiline list 
except the last line must be ended with a \; a, i, and c commands 
and associated input are permitted; the . terminating input mode 
may be omitted if it would be the last line of the command list . An 
empty command list is equivalent to the p command. The g,G,v, 
and V commands are not permitted in the command list . See also 
Notes and the last paragraph before Files below. 

( 1 , $ )G/regular-expression I 

In the interactive Global command, the first step is to mark every 
line that matches the given regular expression. Then, for every 
such line, that line is printed, dot (.) is changed to that line, and 
any one command (other than one of the a, c, i, g, G, v, and V 
commands) may be input and is executed. After the execution of 
that command, the next marked line is printed, and so on; a new- 
line acts as a null command; an ampersand (&) causes the re- 
execution of the most recent command executed within the current 
invocation of G. Note that the commands input as part of the exe- 
cution of the G command may address and affect any lines in the ( 
buffer. The G command can be terminated by entering an INTER- 
RUPT. 
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h 

The help command gives a short error message that explains the 
reason for the most recent ? diagnostic. 

H 

The Help command causes ed to enter a mode in which error mes- 
sages are printed for all subsequent ? diagnostics. It will also 
explain the previous diagnostic if there was one. The H command 
alternately turns this mode on and off; it is initially off. 

(•)i 

<text> 

The msert command inserts the given text before the addressed 
line; dot is left at the last inserted line, or if there were no inserted 
lines, at the addressed line. This command differs from the a com- 
mand only in the placement of the input text. Address is not 
legal for this command. 

(.,.+Dj 

The join command joins contiguous lines by removing the 
appropriate newline characters. If only one address is given, this 
command does nothing. 

(.)k* 

The mar/: command marks the addressed line with name x, which 
must be a lowercase letter. The address 'x then addresses this line; 
dot is unchanged. 

(.,.)l 

The /ist command prints the addressed lines in an unambiguous 
way: a few nonprinting characters (e.g., tab, backspace) are 
represented by mnemonic overstrikes, all other nonprinting charac- 
ters are printed in octal, and long lines are folded. An / command 
may be appended to any command other than e,f, r, or w. 

(.,.)ma 

The move command repositions the addressed line(s) after the line 
addressed by a. Address is legal for a and causes the addressed 
line(s) to be moved to the beginning of the file; it is an error if 
address a falls within the range of moved lines; dot is left at the 
last line moved. 

UOn 

The number command prints the addressed lines, preceding each 
line by its line number and a tab character; dot is left at the last 
line printed. The n command may be appended to any command 
) other than e ,/, r , or w . 

(.,0p 

The print command prints the addressed lines; dot is left at the last 
line printed. The p command may be appended to any command 
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other than e,f,r, or vv; for example, dp deletes the current line and 
prints the new current line. 

P 

The editor will prompt with a * for all subsequent commands. The 
P command alternately turns this mode on and off; it is initially on. 

q 

The quit command causes ed to exit. No automatic write of a file 
is done. 

Q 

The editor exits without checking if changes have been made in 
the buffer since the last w command. 

($)rfile 

The read command reads in the given file after the addressed line. 
If no filename is given, the currently remembered filename, if any, 
is used (see e and / commands). The currently remembered 
filename is not changed unless file is the very first filename men- 
tioned since ed was invoked. Address is legal for r and causes 
the file to be read at the beginning of the buffer. If the read is suc- 
cessful, the number of characters read is typed; dot is set to the last 
line read in. If file begins with !, the rest of the line is taken to be a 
shell (sh (C)) command whose output is to be read. Such a shell 
command is not remembered as the current filename. 

( . , . )s/regular-expression I replacement I or 

( . , . ^/regular-expression /replacement /g or 

( . , . ^/regular-expression /replacement /n n=l-512 

The substitute command searches each addressed line for an 
occurrence of the specified regular expression. In each line in 
which a match is found, all (nonoverlapped) matched strings are 
replaced by the replacement if the global replacement indicator g 
appears after the command. If the global indicator does not 
appear, only the first occurrence of the matched string is replaced. 
It is an error for the substitution to fail on all addressed lines. Any 
character other than space or newline may be used instead of / to 
delimit the regular expression and the replacement; dot is left at 
the last line on which a substitution occurred. 

An ampersand (&) appearing in the replacement is replaced by the 
string matching the regular expression on the current line. The 
special meaning of the ampersand in this context may be 
suppressed by preceding it with a backslash. The characters Xn, 
where n is a digit, are replaced by the text matched by the n-th reg- 
ular subexpression of the specified regular expression enclosed 
between \( and \). When nested parenthesized subexpressions are 
present, n is determined by counting occurrences of \( starting 
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from the left. When the character % is the only character in the 
replacement , the replacement used in the most recent substitute 
command is used as the replacement in the current substitute com- 
mand. The % loses its special meaning when it is in a replace- 
ment string of more than one character or is preceded by a \. 

A line may be split by substituting a newline character into it. The 
newline in the replacement must be escaped by preceding it with a 
\. Such a substitution cannot be done as part of a g or v command 
list. 

(.,.)ta 

This command acts just like the m command, except that a copy of 
the addressed lines is placed after address a (which may be 0); dot 
is left at the last line of the copy. 

u 

The undo command nullifies the effect of the most recent com- 
mand that modified anything in the buffer, namely the most recent 
a,c,d, g, m, r, s, t, v, G, or V command. 

( 1 , $ )\/regular-expression /command list 

This command is the same as the global command g except that 
the command list is executed with dot initially set to every line 
that does not match the regular expression. 

( 1 , $ )V/regular-expression I 

This command is the same as the interactive global command G 
except that the lines that are marked during the first step are those 
that do not match the regular expression. 

(l,$)wfile 

The write command writes the addressed lines into the named file. 
If the file does not exist, it is created with mode 666 (readable and 
writeable by everyone), unless the umask setting (see sh{C)) dic- 
tates otherwise. The currently remembered filename is not 
changed unless file is the very first filename mentioned since ed 
was invoked. If no filename is given, the currently remembered 
filename, if any, is used (s# e e and/ commands); dot is unchanged. 
If the command is successful, the number of characters written is 
displayed. If file begins with an exclamation (!), the rest of the 
line is taken to be a shell command to which the addressed lines 
are supplied as the standard input. Such a shell command is not 
remembered as the current filename. 

($)= 

The line number of the addressed line is typed; dot is unchanged 
by this command. 

Is he 11 command 

The remainder of the line after the ! is sent to the XENIX shell 
(sh(C)) to be interpreted as a command. Within the text of that 
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command, the unescaped character % is replaced with the remem- 
bered filename; if a ! appears as the first character of the shell com- 
mand, it is replaced with the text of the previous shell command. 
Thus, !! will repeat the last shell command. If any expansion is 
performed, the expanded line is echoed; dot is unchanged. 

(.+D 

An address alone on a line causes the addressed line to be printed. 
A RETURN alone on a line is equivalent to .+lp. This is useful for 
stepping forward through the editing buffer a line at a time. 

If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ques- 
tion mark (?) and returns to its command level. 

Some size limitations: 512 characters per line, 256 characters per glo- 
bal command list, 64 characters per filename, and 128K characters in 
the buffei The limit on the number of lines depends on the amount of 
user memory. 

When reading a file, ed discards ASCII NUL characters and all charac- 
ters after the last newline. Files (e.g., a.out) that contain characters 
not in the ASCII set (bit 8 on), cannot be edited by ed. 

If the closing delimiter of a regular expression or of a replacement 
string (e.g., /) would be the last character before a newline, that delim- 
iter may be omitted, in which case the addressed line is printed. Thus, 
the following pairs of commands are equivalent: 
s/sl/s2 s/sl/s2/p 
g/sl g/sl/p 
?sl ?sl? 



Files 

/tmp/e# Temporary; # is the process number 
ed.hup Work is saved here if the terminal is hung up 

See Also 

grep(C), sed(C), sh(C), stty(C), regexp(S) 

Diagnostics 

? Command errors 
? file An inaccessible file 

Use the /zelp and Help commands for detailed explanations. 
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If changes have been made in the buffer since the last w command that 
wrote the entire buffer, ed warns the user if an attempt is made to des- 
troy ed's buffer via the e or q commands: it prints ? and allows you to 
continue editing. A second e or q command at this point will take 
effect. The dash (-) command-line option inhibits this feature. 



Notes 

An exclamation (!) command cannot be subject to a g or a v com- 
mand. 

The ! command and the ! escape from the e, r, and w commands can- 
not be used if the the editor is invoked from a restricted shell (see 
sh(C)). 

The sequence \n in a regular expression does not match any character. 
The / command mishandles DEL. 

Because is an illegal address for the w command, it is not possible to 
create an empty file with ed. 

Characters are mashed to 7 bits on input. 

If the editor input is coming from a command file (i.e., edfile < ed- 
cmd-file), the editor will exit at the first failure of a command in the 
command file. 
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Name 

enable - Turns on terminals and line printers. 

Syntax 

enable tty ... 
enable printers 

Description 

For terminals this program manipulates the /etc/ttys file and signals 
init to allow logins on a particular terminal. 

For line printers, enable activates the named printers and enables them 
to print requests taken by lp(C). Use lpstat(C) to find the status of the 
printers. 

Examples 

A simple command to enable ttyOl follows: 
enable ttyOl 

Files 

/dev/tty* 

/etc/ttys 

/usr/spool/lp/* 

See Also 

disable(C), getty(M), init(M), login(M), lp(C), lpstat(C), ttys(F), 
ungetty(M) 
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Name 

env - Sets environment for command execution. 



Syntax 

env [-] [ name=value ] ... [ command args ] 



Description 

env obtains the current environment , modifies it according to its argu- 
ments, then executes the command with the modified environment. 
Arguments of the form name rvalue are merged into the inherited 
environment before the command is executed. The - flag causes the 
inherited environment to be ignored completely, so that the command 
is executed with exactly the environment specified by the arguments. 

If no command is specified, the resulting environment is printed, one 
name- value pair per line. 



See Also 

sh(C), exec(S), profile(F), environ(M) 



Notes 

The 2.3 printenv command has been replaced in XENIX 3.0 and Sys- 
tem V by the env command. The printenv shipped is a link to the 
command env. 
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Name 

ex - Invokes a text editor. 



Syntax 

ex [ - ] [ -v ] [ -t tag ] [ -r ] [ +lineno ] name ... 



Description 

ex is the root of the editors ex and vi. ex is a superset of ed, whose 
most notable extension is a display editing facility. Display based 
editing is the focus of vi. 

If you have not used ed, or if you are a casual user, you will find that 
edit is most convenient for you. It avoids some of the complexities of 
ex which is used mostly by systems programmers and persons very 
familiar with ed. 

If you have a CRT terminal, you may wish to use a display based edi- 
tor; in this case see v/(C), a command which focuses on the display 
editing portion of ex. 



For ed Users 

If you have used ed you will find that ex has a number of new features. 
Intelligent terminals and high-speed terminals are very pleasant to 
use with vi. Generally, the ex editor uses far more of the capabilities 
of terminals than ed does. It uses the terminal capability database 
termcap (M) and the type of the terminal you are using from the vari- 
able TERM in the environment to determine how to drive your termi- 
nal efficiently. The ex editor makes use of features such as insert and 
delete character and line in its visual command mode, which can be 
abbreviated vi , which is the central mode of editing when using vz'(C). 
There is also an interline editing open command, (o) that works on all 
terminals. 

ex contains a number of features for easily viewing the text of a file. 
The z command gives easy access to windows of text. Hitting Ctrl-D 
causes the editor to scroll a half-window of text and is more useful for 
quickly stepping through a file than just hitting the RETURN key. Of 
course, the screen-oriented visual mode gives constant access to edit- 
ing context. 
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ex gives you more help when you make mistakes. The undo (u) com- 
mand allows you to reverse any single change, ex gives you a lot of 
feedback, normally printing changed lines, and indicates when more 
than a few lines are affected by a command so it is easy to detect 
when a command has affected more lines than it should have. 

The editor also normally prevents the overwriting of existing files 
unless you have edited them, so that you do not accidentally clobber 
with a write a file other than the one you are editing. If the system (or 
editor) crashes, or you accidentally hang up the phone, you can use the 
recover command to retrieve your work. This will get you back to 
within a few lines of where you left off. 

ex has several features for editing more than one file at a time. You 
can give it a list of files on the command line and use the next (n) 
command to edit each in turn. You can also give the next command a 
list of filenames, or a pattern used by the shell to specify a new set of 
files to be edited. In general, filenames in the editor may be formed 
with full shell metasyntax. The metacharacter "%" is also available 
in forming filenames and is replaced by the name of the current file. 
For editing large groups of related files, you can use ex's tag command 
to quickly locate functions and other important points in any of the 
files. This is useful when you want to find the definition of a particu- 
lar function in a large program. The command ctags(CP) builds a tags 
file or a group of C programs. 

For moving text between files and within a file, the editor has a group 
of buffers named a through z. You can place text in these named 
buffers and carry it over when you edit another file. 

The command & repeats the last substitute command. There is also a 
confirmed substitute command. You give a range of substitutions to 
be done and the editor interactively prompts you whether each substi- 
tution is desired. 

You can use the substitute command in ex to systematically convert 
the case of letters between uppercase and lowercase. It is possible to 
ignore case in searches and substitutions, ex also allows regular 
expressions that match words to be constructed. This is convenient, 
for example, when searching for the word "edit" if your document 
also contains the word "editor." 

ex has a set of options that you can set. One option which is very use- 
ful is the autoindent option that allows the editor to automatically sup- 
ply leading white space to align text. You can then press Ctrl-D to 
backtab, space and tab forward to align new code easily. 

Miscellaneous new useful features include an intelligent join (j) com- 
mand which supplies whitespace between joined lines automatically, 
the commands < and > which shift groups of lines, and the ability to 
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filter portions of the buffer through commands such as sort. 



Files 

/usr/lib/ex3.7strings 

/usr/lib/ex3.7recover 

/usr/lib/ex3 .7preserve 

/etc/termcap 

$HOME/.exrc 

/tinp/Exnnnnn 

/tmp/Rxnnnnn 

/usr/preserve 



Error messages 

Recover command 

Preserve command 

Describes capabilities of terminals 

Editor startup file 

Editor temporary 

Named buffer temporary 

Preservation directory 



See Also 

awk(C), ctags(CP), ed(C), grep(C), sed(C), termcap(M), vi(C) 



Credit 



This utility was developed at the University of California at Berkeley 
and is used with permission. 



Notes 

The undo command causes all marks to be lost on lines changed and 
then restored if the marked lines were changed. 

Undo never clears the buffer modified condition. 

The z command prints a number of logical rather than physical lines. 
More than a screen full of output may result if long lines are present. 

File input/output errors don't print a name if the command line "-" 
option is used. 

There is no easy way to do a single scan ignoring case. 

Because of the implementation of the arguments to next, only 512 
bytes of argument list are allowed there. 

The format of /etc/termcap and the large number of capabilities of 
terminals used by the editor cause terminal type setup to be rather 
slow. 
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The editor does not warn if text is placed in named buffers and not 
used before exiting the editor. 

Null characters are discarded in input files and cannot appear in resul- 
tant files. 
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Name 

expr - Evaluates arguments as an expression. 



Syntax 

expr arguments 



Description 

The arguments are taken as an expression. After evaluation, the result 
is written on the standard output. Terms of the expression must be 
separated by blanks. Characters special to the shell must be escaped. 
Note that zero is returned to indicate a zero value, rather than the null 
string. Strings containing blanks or other special characters should be 
quoted. Integer-valued arguments may be preceded by a unary minus 
sign. Internally, integers are treated as 32-bit, 2's complement 
numbers. 

The operators and keywords are listed below. Expressions should be 
quoted by the shell, since many of the characters that have special 
meaning in the shell also have special meaning in expr. The list is in 
order of increasing precedence, with equal precedence operators 
grouped within braces ( { and }). 

expr | expr 

Returns the first expr if it is neither null nor 0, otherwise 
returns the second expr . 

expr & expr 

Returns the first expr if neither expr is null nor 0, otherwise 
returns 0. 

expr { =, >, >=, <, <=, != } expr 

Returns the result of an integer comparison if both arguments 
are integers, otherwise returns the result of a lexical com- 
parison. 

expr { +, - } expr 

Addition or subtraction of integer- valued arguments. 

expr { *,/,% } expr 

Multiplication, division, or remainder of the integer-valued 
arguments. 

expr : expr 

The matching operator : compares the first argument with the 
second argument which must be a regular expression; regular 
expression syntax is the same as that of ed(C), except that all 
patterns are "anchored" (i.e., begin with a caret Q) and 
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therefore the caret is not a special character in that context. 
(Note that in the shell, the caret has the same meaning as the 
pipe symbol ( I ).) Normally the matching operator returns the 
number of characters matched (zero on failure). Alternatively, 
the \( . . . \) pattern symbols can be used to return a portion of 
the first argument. 



Examples 

1. a=^expr $a + l v 

Adds 1 to the shell variable a. 

2. # For $a equal to either "/usr/abc/file" or just "/file" 
expr $a : '.*A(.*\)' 

Returns the last segment of a pathname (i.e., file). Watch out 
for the slash alone as an argument: expr will take it as the divi- 
sion operator (see Notes on the next page). 

3. expr $VAR : '.*' 

Returns the number of characters in $VAR. 



ed(C), sh(C) 
Diagnostics 

As a side effect of expression evaluation, expr returns the following 
exit values: 



See Also 




1 
2 



If the expression is neither null nor zero 
If the expression is null or zero 
For invalid expressions 



Other diagnostics include: 



syntax error 



For operator/operand errors 



nonnumeric argument 



If arithmetic is attempted on such a string 
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Notes 

After argument processing by the shell, expr cannot tell the difference 
between an operator and an operand except by the value. If $a is an 
equals sign (=), the command: 

expr $a = = 

looks like: 

expr = ==== 

Thus the arguments are passed to expr (and will all be taken as the = 
operator). The following permits comparing equals signs: 

expr X$a = X= 
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Name 

factor - Factor a number. 



Syntax 

factor [ number ] 



Description 

When factor is invoked without an argument, it waits for a number to 
be typed in. If you type in a positive number less than 2 46 (about 
7.2xl0 13 ) it will factor the number and print its prime factors; each 
one is printed the proper number of times. Then it waits for another 
number. It exits if it encounters a zero or any non-numeric character. 

If factor is invoked with an argument, it factors the number as above 
and then exits. 

The time it takes to factor a number, n, is proportional to V«- It usu- 
ally takes longer to factor a prime or the square of a prime, than to fac- 
tor other numbers. 

Diagnostics 

factor returns an error message if the supplied input value is greater 
than 2 46 or is not an integer number. 
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Name 

false - Returns with a nonzero exit value. 

Syntax 
false 

Description 

false does nothing except return with a nonzero exit value. true(C), 
false' s counterpart, does nothing except return with a zero exit value. 
"False" is typically used in shell procedures such as: 

until false 
do 

command 

done 

See Also 

sh(C), true(C) 

Diagnostics 

false is any non-zero value. 
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Name 

file - Determines file type. 



Syntax 

file [ -m ] file ... 

file [ -m ] -f namesfile 



Description 

file performs a series of tests on each argument in an attempt to clas- 
sify it. If an argument appears to be ASCII, file examines the first 512 
bytes and tries to guess its language. 

If the -f option is given, file takes the list of filenames from namesfile. 
If the -m option is given, file sets the access time for the examined file 
to the current time. Otherwise, the access time remains unchanged. 

Several object file formats are recognized. For a.out and x.out format 
object files, file reports "separate" if the file was linked with cc -i, 
"pure" if the file was linked with cc -n, and "not stripped" if the 
file was not linked with cc -s or strip(CP) was not run. 



Credit 

This utility was developed at the University of California at Berkeley 
and is used with permission. 



Notes 

It can make mistakes: in particular it often mistakes command files 
for C programs. 
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Name 

find - Finds files. 



Syntax 

find pathname-list expression 



Description 

find recursively descends the directory hierarchy for each pathname in 
the pathname-list (i.e., one or more pathnames) seeking files that 
match a Boolean expression written in the primaries given below. In 
the descriptions, the argument n is used as a decimal integer where +n 
means more than n, -n means less than n and n means exactly n. 



-depth 



-name///e 



-perm onum 



-type x 



Always true; causes descent of the directory 
hierarchy to be done so that all entries in a direc- 
tory are acted upon before the directory itself. 
This can be useful when used with cpio(C) to 
transfer files located in directories without write 
permission. 

True if file matches the current file name. Normal 
shell argument syntax may be used if escaped 
(watch out for the left bracket ([), the question 
mark (?) and the star (*). 

True if the file permission flags exactly match the 
octal number onum (see chmod(C)). If onum is 
prefixed by a minus sign, more flag bits (017777, 
see stat(S)) become significant and the flags are 
compared. 

True if the type of the file is x, where c is b, c, d, 
p, or f for block special file, character special file, 
directory, first-in-first-out, or plain file respec- 
tively. 



-links n 



True if the file has n links. 



-inum num True if the file's inode is num. This is useful for 

locating files with matching inodes. 

-user uname True if the file belongs to the user uname . If 
uname is numeric and does not appear as a login 
name in the /etc/passwd file, it is taken as a user 
ID. 
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-group gname True if the file belongs to the group gname. If 
gnome is numeric and does not appear in the 
/etc/group file, it is taken as a group ID. 

-size n True if the file is n blocks long (512 bytes per 

block). 

-atime n True if the file has been accessed in n days. 

-mtime n True if the file has been modified in n days. 

-ctime n True if the file was created in the past n days. 

-exec cmd True if the executed cmd returns a zero value as 

exit status. The end of cmd must be punctuated by 
an escaped semicolon. A command argument { } 
is replaced by the current path name. 

-ok cmd Like -exec except that the generated command 

line is printed with a question mark first, and is 
executed only if the user responds by typing y. 

-cpiodevice Always true; write the current file on device in 

cpio(F) format (5120-byte records). 

-print Always true; causes the current path name to be 

printed. 

-newer file True if the current file has been modified more 

recently than the argument file . 

( expression ) True if the parenthesized expression is true 
(parentheses are special to the shell and must be 
escaped). 

The primaries may be combined using the following operators (in 
order of decreasing precedence): 



negation 

AND 

OR 



The negation of a primary is specified with the 
exclamation (!) unary not operator. 

The AND operation is implied by the juxtaposition 
of two primaries. 



The OR operation is specified with the -o operator 
given between two primaries. 



Example 

The following command searches for files named chapterl in the 
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current directory and all directories below it and sends the pathname 
of any such files it finds to the standard output: 

find . -name chapterl -print 

The following removes all files named a.out or *.out that have not 
been accessed for a week: 

find / X -name a.out -o -name '*.out'\) -atime +7 -exec rm { } \ 

Files 

/etc/passwd 
/etc/group 

See Also 

cpio(C)(F), sh(C), stat(S), test(C) 
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Name 



finger - Finds information about users. 



Syntax 



finger [ -bfilpqsw ] [login 1 [login2 ...] ] 



Description 

By default finger lists the login name, full name, terminal name and 
write status (as a "*" before the terminal name if write permission is 
denied), idle time, login time, office location, and phone number (if 
they are known) for each current XENIX user. (Idle time is minutes if 
it is a single integer, hours and minutes if a colon (:) is present, or 
days and hours if a "d" is present.) 

A longer format also exists and is used by finger whenever a list of 
names is given. (Account names as well as first and last names of 
users are accepted.) This is a multiline format; it includes all the 
information described above as well as the user's home directory and 
login shell, any plan which the person has placed in the file .plan in 
their home directory, and the project on which they are working from 
the file .project which is also in the home directory. 

finger options are: 



-b 


Briefer long output format of users. 


-f 


Suppresses the printing of the header line (short format). 


-i 


Quick list of users with idle times. 


-1 


Forces long output format. 


P 


Suppresses printing of the .plan files. 


-q 


Quick list of users. 


-s 


Forces short output format. 


-w 


Forces narrow format list of specified users. 



Files 



/etc/utmp 
/etc/passwd 



Who file 



User names, offices, 
login directories, and shells 



phones, 
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$HOME/.plan 
$HOME/.project 



Plans 



Projects 



See Also 



who(C) 



Credit 



This utility was developed at the University of California at Berkeley 
and is used with permission. 



Only the first line of the .project file is printed. 

Entries in the /etc/passwd file have the following format: 

login name:user password*, coded) :user ID:group ID: comments :home 
directory :lo gin shell 

The comment field corresponds to configurable columns in the finger 
output. For example, in the following /etc/passwd entry: 

blf:Tg6bLFzOwgfbA:47:5:Brian Foster, Mission, x70, 767-1234 
:/u/blf:/bin/shV 

the comment field, "Brian Foster, Mission, x70, 767-1234" , contains 
data for the "In Real Life" , "Office" , and "Home Phone" , columns 
of the finger listings. 

Idle time is computed as the elapsed time since any activity on the 
given terminal. This includes previous invocations of finger which 
may have modified the terminal's corresponding device file /dev/tty??. 



Notes 
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Name 

fixhdr - Changes executable binary file headers. 



Syntax 

fixhdr option files 



Description 

fixhdr changes the header of output files created by link editors or 
assemblers. The kinds of modifications include changing the format of 
the header, the fixed stack size, the standalone load address, and sym- 
bol names. 

Using fixhdr allows the use of binary executable files, created under 
other versions or machines, by simply changing the header informa- 
tion so that it is usable by the target cpu. 

These are the options to fixhdr : 

-xa Change the x.out format of the header to the a.out format. 

-xb Change the x.out format of the header to the b.out format. 

-x4 Change the x.out format of the header to the 4.2BSD a.out 

format. 

-x5 [-n] Change the x.out format of the header to 5.2 (UNIX™ 
System V release 2) a.out format. The -n flag causes 
leading underscores on symbol names to be passed with 
no modifications. 

-ax -c [11,86] 

Change the a.out format of the header to the x.out format. 
The -c flag specifies the target cpu. 11 specifies a PDP-11 
cpu. 86 specifies one of the 8086 family of cpus (8086, 
8088, 80186, 80286 or 80386). 

Change the b.out format of the header to the x.out format. 

Change the 5.2 (UNIX System V release 2) a.out format 
of the header to the x.out format. The -n flag causes lead- 
ing underscores on symbol names to be passed with no 
modifications. 

Add the x.out header format to the 86rel object module 
format. See 86rel(F). 



-bx 

-5x [-n] 
-86x 
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-F num Add (or change) the fixed stack size specified in the x.out 
format of the header, num must be a hexadecimal 
number. 

-A num Add (or change) the standalone load address specified in 
the x.out format of the header, num must be a hexade- 
cimal number. 

-M[smlh] Change the model of the x.out or 86rel format. Model 
refers to the compiler model specified when creating the 
binary, s refers to small model, m refers to medium 
model, 1 refers to large model, and h refers to huge model. 

-v [2,3,5,7] Change the version of XENIX specified in the header. 
XENIX version 2 was based on UNIX Version 7. 

-s sl=s2 [-s s3=s4] 

Change symbol names, where symbol name si is changed 
to s2. 



-r Ensure that the resolution table is of non-zero size. 

-C cpu Set the cpu type, cpu can be 186, 286, 386, 8086, others. 



Files 

/usr/bin/fixhdr 



See Also 

a.out(F), 86rel(F) 



Notes 



Give fixhdr one option at a time. If you need to make more than one 
kind of modification to a file, use fixhdr on the original file. Then use it 
again on the fixhdr output, specifying the next option. Copy the origi- 
nal file if you need an unmodified version as fixhdr makes the 
modifications directly to the file. 
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Name 

format - format floppy disks 



Syntax 

format [-n] [-v] [-e] [-f] [-q] [device] [-i interleave] 



Description 

format formats diskettes for use with XENIX. It may be used either 
interactively or from the command line. The default drive is 
/dev/rfdO. 



Options 

The following command line options are available: 

-f Suppresses the interactive feature. The format program does not 
wait for user-confirmation before starting to format the diskette. 
Regardless of whether or not you run format interactively, track 
and head information is displayed. 

-e Erases the servo information on a mini-cartridge. 

device 

This specifies the device to be formatted. The default device is 
/dev/rfdO . 

-i interleave 

Specifies the interleave factor. 

-q Quiet option. Suppresses the track and head output information 
normally displayed. Although this option does not suppress the 
interactive prompt, it would typically be used with -f to produce no 
output at all. 

-v Specifies format verification. 

-n Specifies that the diskette is not to be verified (overrides verify 
entry in /etc/default/format). 

The file /etc/default/format is used to specify the default device to be 
formatted and whether or not each diskette is to be verified. The 
entries must be in the format DEVICE=/dev/rfd«nn and 
VERIFY=[yYnN], as in the following example: 

DEVICE=/dev/rfd096dsl5 
VERIFY=y 
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The device must be a character (raw) device. 
Usage 

To run format interactively, enter: 
format 

followed by any of the legal options except -f, and press RETURN. 
When you run format interactively, you see the prompt: 

insert diskette in drive and press return when ready 

When you press RETURN at this prompt, format begins to format the 
diskette. 

If you specify the -f option, you do not see this prompt. Instead, the 
program begins formatting immediately upon invocation. 

Unless you specify the -q option, format displays which track and 
head it is currently on: 

track # head # 

The number signs above are replaced by the actual track and head 
information. 

Files 

/etc/ default/format 
/dev/rfd[0-n] 

See Also 

fd(HW) 

Notes 

The format utility does not format floppies for use under DOS; use the 
dosformat command documented in dosiC). 

XENIX requires error free floppies. 

It is not advisable to format a low density (48tpi) diskette on a high 
density (96tpi) floppy drive. Diskettes written on a high density drive 
should be read on high density drives. A low density diskette written 
on a high density drive may not be readable on a low density drive. 
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Name 

getopt - Parses command options. 

Syntax 

set -- s getopt optstring $* s 



GETOPT (C) 



Description 

getopt is used to check and break up options in command lines for 
parsing by shell procedures. Optstring is a string of recognized option 
letters (see getopt (S)). If a letter is followed by a colon, the option is 
expected to have an argument which may or may not be separated 
from it by whitespace. The special option --is used to delimit the end 
of the options, getopt will place --in the arguments at the end of the 
options, or recognize it if used explicitly. The shell arguments ($1 $2 . 
. .) are reset so that each option is preceded by a dash (-) and in its own 
shell argument; each option argument is also in its own shell argu- 
ment. 



Example 

The following code fragment shows how one can process the argu- 
ments for a command that can take the options a and b, and the option 
o, which requires an argument: 

set - - v getopt abo: $* v 

if [ $? != ] 

then 

echo $USAGE 
exit 2 

fi 

for i in $* 
do 

case $i in 

-a I -b) FLAG=$i; shift;; 

-o) OARG=$2; shift; shift;; 

- -) shift; break;; 

esac 

done 

This code will accept any of the following as equivalent: 

cmd -aoarg file file 
cmd -a -o arg file file 
cmd -oarg -a file file 
cmd -a -oarg ~ file file 
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See Also 



sh(C), getopt(S) 
Diagnostics 

getopt prints an error message on the standard error when it 
encounters an option letter not included in optstring . 

Notes 

The "Syntax" given for this utility assumes the user has a sh(C) shell. 
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Name 

grep, egrep, fgrep - Searches a file for a pattern. 



Syntax 

grep [ -bchlnsvy ] [ expression ] [ files ] 
egrep [ -bchlnv ] [ expression ] [ files ] 
fgrep [ -bclnvxy ] [ strings ] [ files ] 



Description 

Commands of the grep family search the input files (standard input 
default) for lines matching a pattern. Normally, each line found is 
copied to the standard output, grep patterns are limited regular 
expressions in the style of ed(C); it uses a compact nondeterministic 
algorithm, egrep patterns are full regular expressions; it uses a fast 
deterministic algorithm that sometimes needs exponential space. 
fgrep patterns are fixed strings; it is fast and compact. The following 
options are recognized: 

-v All lines but those matching are displayed. 

-x Displays only exact matches of an entire line, (fgrep only.) 

-c Only a count of matching lines is displayed. 

-1 Only the names of files with matching lines are displayed, 
separated by newlines. 

-h Prevents the name of the file containing the matching line from 
being appended to that line. Used when searching multiple 
files. 

-n Each line is preceded by its relative line number in the file. 

-b Each line is preceded by the block number on which it was 
found. This is sometimes useful in locating disk block 
numbers by context. 

-s Suppresses error messages produced for nonexistent or unread- 
able files. ( grep only.) Note that the -s option will not 
suppress error messages generated by the -f option. 

-y Turns on matching of letters of either case in the input so that 
case is insignificant. Does not work for egrep. 
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-e expression 

Same as a simple expression argument, but useful when the 
expression begins with a dash (-). 

-ifile 

The regular expression for grep or egrep, or strings list (for 
fgrep) is taken from the^/e. 

In all cases, the filename is output if there is more than one input file. 
Care should be taken when using the characters $,*,[, M ,(, ). and \ in 
expression , because they are also meaningful to the shell. It is safest 
to enclose the entire expression argument in single quotation marks. 

Fgrep searches for lines that contain one of the strings separated by 
newlines. 

Egrep accepts regular expressions as in ed(C), except for \( and \), 
with the addition of the following: 

- A regular expression followed by a plus sign (+) matches one or 
more occurrences of the regular expression. 

- A regular expression followed by a question mark (?) matches or 
1 occurrences of the regular expression. 

- Two regular expressions separated by a vertical bar (I) or by a 
newline match strings that are matched by either regular expres- 
sion. 

- A regular expression may be enclosed in parentheses ( ) for group- 
ing. 

The order of precedence of operators is [ ], then * ? +, then concatena- 
tion, then the backslash (\) and the newline. 



See Also 

ed(C), sed(C), sh(C) 



Diagnostics 

Exit status is if any matches are found, 1 if none, 2 for syntax errors 
or inaccessible files. 



Notes 

Ideally there should be only one grep, but there isn't a single algo- 
rithm that spans a wide enough range of space-time tradeoffs. 
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Lines are limited to 256 characters; longer lines are truncated. 

When using grep with the -y option, the search is not made totally 
case insensitive in character ranges specified within brackets. 

Multiple strings can be specified in fgrep without using a separate 
strings file by using the quoting conventions of the shell to imbed 
newlines in the single string argument. For example, you might enter 
the following on the command line: 

fgrep 'string 1 
string2 

string3' text, file 

Similarly, multiple strings can be specified in egrep by doing: 

egrep 'string II string2l string3' text, file 
Thus egrep can do almost anything that grep and fgrep can do. 
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Name 

grpcheck - Checks group file. 

Syntax 

grpcheck [file] 

Description 

grpcheck verifies all entries in the group file. This verification 
includes a check of the number of fields, group name, group ID, and 
whether all login names appear in the password file. The default group 
file is /etc/group. 

Files 

/etc/group 
/etc/passwd 

See Also 

pwcheck(C), group(F), passwd(F) 

Diagnostics 

Group entries in /etc/group with no login names are flagged. 
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Name 

hd - Displays files in hexadecimal format. 



Syntax 

hd [ -format [ -s offset ] [ -n count ] [ file ] ... 



Description 

The hd command displays the contents of files in hexadecimal, octal, 
decimal, and character formats. Control over the specification of 
ranges of characters is also available. The default behavior is with the 
following flags set: "-abx -A". This says that addresses (file offsets) 
and bytes are printed in hexadecimal and that characters are also 
printed. If no file argument is given, the standard input is read. 

Options include: 

-s offset Specify the beginning offset in the file where printing is 
to begin. If no 'file' argument is given, or if a seek fails 
because the input is a pipe, 'offset' bytes are read from 
the input and discarded. Otherwise, a seek error will 
terminate processing of the current file. 

The offset may be given in decimal, hexadecimal (pre- 
ceded by 'Ox'), or octal (preceded by a '0'). It is option- 
ally followed by one of the following multipliers: w, 1, 
b, or k; for words (2 bytes), long words (4 bytes), half 
kilobytes (512 bytes), or kilobytes (1024 bytes). Note 
that this is the one case where "b" does not stand for 
bytes. Since specifying a hexadecimal offset in blocks 
would result in an ambiguous trailing 'b', any offset and 
multiplier may be separated by an asterisk (*). 

-n count Specify the number of bytes to process. The count is in 
the same format as offset, above. 

Format Flags 

Format flags may specify addresses, characters, bytes, words (2 bytes) 
or longs (4 bytes) to be printed in hex, decimal, or octal. Two special 
formats may also be indicated: text or ascii. Format and base 
specifiers may be freely combined and repeated as desired in order to 
specify different bases (hexadecimal, decimal or octal) for different 
output formats (addresses, characters, etc.). All format flags appearing 
in a single argument are applied as appropriate to all other flags in that 
argument. 
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acbwlA 

Output format specifiers for addresses, characters, bytes, words, 
longs and ascii respectively. Only one base specifier will be used 
for addresses; the address will appear on the first line of output that 
begins each new offset in the input. 

The character format prints printable characters unchanged, spe- 
cial C escapes as defined in the language, and the remaining values 
in the specified base. 

The ascii format prints all printable characters unchanged, and all 
others as a period (.). This format appears to the right of the first of 
other specified output formats. A base specifier has no meaning 
with the ascii format. If no other output format (other than 
addresses) is given, bx is assumed. If no base specifier is given, all 
of xdo are used. 

hxdo 

Output base specifiers for hexadecimal, decimal and octal. If no 
format specifier is given, all of acbwl are used. 

t Print a text file, each line preceded by the address in the file. Nor- 
mally, lines should be terminated by a \n character; but long lines 
will be broken up. Control characters in the range 0x00 to Ox If are 
printed as '~@' to Bytes with the high bit set are preceded by 
a tilde (~) and printed as if the high bit were not set. The special 
characters ~, \) are preceded by a backslash (\) to escape their 
special meaning. As special cases, two values are represented 
numerically as M77' and '\377'. This flag will override all output 
format specifiers except addresses. 
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Name 

head - Prints the first few lines of a stream. 

Syntax 

head [ -count ][ file ... ] 

Description 

This filter prints the first count lines of each of the specified files. If 
no files are specified, head reads from the standard input. If no count 
is specified, then 10 lines are printed. 

See Also 

tail(C) 

Credit 

This utility was developed at the University of California at Berkeley 
and is used with permission. 
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Name 

hello - Send a message to another user. 



Syntax 

hello user [ tty ] 



Description 

hello sends messages from one user to another. When first called, 
hello displays the following message: 

Message from sender' s-system! sender' s-name sender' s-tty 

The recipient of the message should write back at this point. Com- 
munication continues until an interrupt is sent. (On most terminals, 
pressing the Del key sends an interrupt.) At that point hello prints 
"EOT" on the other terminal, and exits. 

To write to a user who is logged in more than once, the user can 
employ the tty argument to specify the appropriate terminal name. 
The who(C) command can be used to determine the correct terminal 
name. 

Permission to write may be allowed or denied by the recipient, using 
the mesg command. Writing is allowed by default. Certain com- 
mands, such as nroff and pr, prohibit messages in order to prevent 
disruption of output. 

If the character ! is found at the beginning of a line, hello calls the 
shell to execute the rest of the line as a command. 

The following protocol is suggested for using hello. When first writ- 
ing to another user, the sender should wait for that user to write back 
before sending a message. Each party should end each message with a 
signal indicating that the other may reply: o for "over" is conven- 
tional. The signal oo for "over and out" is suggested when conversa- 
tion is about to be terminated. 



Files 

/etc/utmp 
/bin/sh 



See Also 

mesg(C), who(C), mail(C) 
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Name 



help - Asks for help with XENIX commands and SCCS error messages. 



help [command] [imessagenumber] 



Description 

help provides on-line explanations of most commonly-used XENIX 
commands, help also displays information explaining SCCS error 
messages. Multiple arguments can be supplied. If no arguments are 
given, help will prompt for one. 

The arguments may be XENIX command names or SCCS message 
numbers. Message numbers are displayed at the end of SCCS error 
messages. SCCS message numbers come in two forms: numbers and 
letter-number combinations (for example, ge6 or 212). 

When all else fails, try "help stuck". 



Syntax 



Files 



/usr/lib/help 



Directory containing files of message text 
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Name 

hwconfig - read the configuration information. 
Syntax 

hwconfig [-f filename] [param] [param=val] ... 
Description 

hwconfig returns the configuration information contained in the file 
/usr/adm/hwconfig or the file specified on the command line with the 
-f filename option. Using combinations of the remaining options, the 
user can view as much information as needed from the configuration 
file, shows all values of param throughout the configuration file. 
param can be any valid system parameter, shows only information 
from the line where param equals the value val. 

Examples 

When you enter: 
hwconfig <RETURN> 

The entire contents of the file /usr/adm/hwconfig is printed, 
hwconfig base <RETURN> 

All the values of the base parameter found in /usr/adm/hwconfig are 
printed. 

hwconfig -f conf base=300 vec=19 <RETURN> 

All entries in conf that match the base and vec values given are 
printed. 

hwconfig name=floppy base <RETURN> 

The name and value of base in /usr/adm/hwconfig for the drivers with 
the name floppy are printed for all entries. 

Files 

/usr/adm/hwconfig 
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Name 

id - Prints user and group IDs and names. 

Syntax 
id 

Description 

Id writes a message on the standard output, giving the user and group 
IDs and the corresponding names of the invoking process. If the effec- 
tive and real IDs do not match, both are printed. 

See Also 

logname(C), getuid(S) 
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Name 

imacct - Generate an IMAGEN accounting report. 

Syntax 

imacct acctfile 

Description 

imacct reads the IMAGEN accounting file acctfile and generates a 
report on the number of pages and files printed. It tallies this informa- 
tion per each user on each host computer, and provides totals and per- 
centages. 

The accounting file is generated by the serial "sequence packet proto- 
col' ' IMAGEN printer handler ips (ADM). 

Files 

Aisr/adm/imagen Default acctfile written 

by imagen.spp. 

See Also 

imagen(M), 
ips(ADM) 

Notes 

No sorting option is available. 

Author 

IMAGEN Corporation. 
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Name 

imprint - Prints text files on an IMAGEN printer. 



Syntax 

imprint [ options ] [ file... ] 



Description 

imprint queues the specified files for printing on an IMAGEN printer 
using either pr(C) or cat(C), and passes the correct options to ipr(C). 
If no files are given, the standard input is read. 

The options are: 

-Iflag 

Pass flag to ipr. 

-Vflag 

Pass flag to either pr or cat. 
-Yprinter 

Print the output on printer. The default printer is specified as 
PRINTER in the file /etc/default/imagen, which is read by ipr. 

-cn 

Print n copies. This turns on pagecollation. 
-h banner 

The string banner is passed to both pr (-h) and ipr (-f) as the 
header for this job. 

-In 

Set the page length to n lines. This may also set the printer's inter- 
line spacing. 

-n Use cat rather than pr to print the file. 

-w« 

Set the the line width to n characters. A line width of more than 80 
characters is printed in landscape (132 column) mode. 

-2 Print two logical pages per physical page ("2-up"). 

-C Suppress pagecollation (see -c above). 

-F Suppress pagereversal (which is on by default). 
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-J Suppress generation of the job header page. 

-L Print in landscape mode, 132 columns wide. 

-O Print page borders. 

-R Print page rules (one every two lines). 

-d Prints some information for debugging purposes. 

-on 

The output is offset n character positions from the left margin. 
-Tn 

The output begins n 1/48 's of an inch from the top of the each 
page. 



See Also 

cat(C),ipr(C),pr(C) 



Notes 

Certain parameters can be overridden by document control language 
in the file itself. Also, a -c flag after a -C flag turns pagecollation on 
once more. 

If the job contains errors detected by the printer, the job header page is 
always generated. 

The -T option is meaningful only if the IMAGEN printer language is 
"daisy." This can be set by -I-Ldaisy. If the printer language is 
daisy, then the -o option uses units of 1/120 of an inch, rather a char- 
acter width. 

Older versions of imprint passed any unrecognized option on to either 
pr or cat. This is no longer supported, and either -p or the "end of 
options''' delimiter — must be used to pass an unmolested option to 
either pr or cat. 



Author 

IMAGEN Corporation. 
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Name 

ipr, oldipr - Put files onto the IMAGEN printer queue. 



Syntax 

ipr [ options ] [file... ] 
oldipr [ options ] [ file... ] 



Description 

ipr causes the named files to be queued for printing on an IMAGEN 
printer, using lp(C), with the appropriate document control language 
strings prepended. Some of the information in the document header 
includes the number of copies, the names of the printed files, and the 
IMAGEN printer language used. If no files are named, the standard 
input is read. 

oldipr is identical to ipr, but implies the -o option and is used with 
old-style imPRESS files. 

The options are: 

-L language 

Causes the specified language declaration to be included in the 
document control language string for the queued files. This should 
correspond to the language in which the document was prepared. 

-D string 

Causes string to be included in the document control language for 
the queued files. 

-P printer 

This file is to be printed on printer . The default printer is specified 
as PRINTER in the file /etc/default/imagen. 

-iname 

Imbed the identifier name as the value of the variable files in the 
document control language. If not specified, the names of the 
input files are used. This is printed on the banner page. 

-m 

Causes mailiC) to be sent when the job is complete, 
-r The files will be unlinked after being queued for printing, 
-cn 

Prints n copies. 
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-d Additional information is printed for debugging purposes. 

-o Specifies that the file being queued is an old style (prior to version 
1) imPRESS-language format file. 

ipr reads /etc/default/imagen to obtain various default settings. The 
values obtained and the default values are: 

PRINTER=imagen 

The name of the IMAGEN printer. This can be overridden with the 
-P option. 

JAMPROOF=no 

Whether or not paper-jam resistance measures should be used. If 
such steps are taken, printing is usually slowed down. 

The values for the default settings can be changed to reflect the local 
system configuration. If /etc/default/imagen does not exist or cannot 
be read, the above default values are used. 



Files 

/usr/bin/lp 

The XENIX printer spooling system. 



See Also 

imagen(M), imprint(C), ips(ADM), itroff(CT), lp(C) 



Notes 

The number of copies to be printed and other parameters can be over- 
ridden by document-control information contained within the docu- 
ment itself. 



Author 

IMAGEN Corporation. 



I 
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Name 

iprint - Converts text files to DVI format. 



Syntax 

iprint [ options ] [ file... ] 



Description 

iprint converts the input text files to DVI format. The DVI output must 
first be converted to imPRESS format before it can be printed on an 
IMAGEN printer. Unless the -i option is given, dviimp (CT) is used to 
automatically preform this conversion and print the results. If no file 
names are given, the standard input is read. 

The options are: 

-i output 

The imPRESS is saved in file output instead of being printed, 
-b banner 

The string banner is passed on to dviimp as the argument to its -b 
option. The default banner is the name of the first input file. 

-cn 

Print n copies. 

-B Print the first non-blank line on each page in a bold type face, and 
ignore leading blank lines. This is for use with programs like 
pr(C) which generate page headers. 

-ffont 

Use the following argument as the name of a font file for the text. 
A variable-pitch font will generally produce ugly results. 

-Ffont 

Use the following argument as the name of a font file for the bold 
header line. See the -B option). 

-on 

Print with a page offset (left margin) of n spaces. 



Take the page length to be n lines. 
-D raster 

The directory containing the raster images is raster. The default 
raster image directory is specified by RASTER in the file 
/etc/default/imagen, and has an assumed resolution of 240 pixels 
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per inch. 

-d Produces extensive output for debugging, 
-v Produces more verbose debugging output. 

iprint reads /etc/default/imagen to obtain various default settings. 
The values obtained and the default values are: 

RASTER=/usrAib/imagen/raster 

The font rasterization files are to be found in directory 240 within 
this directory (i.e. raster /240). This can be overridden by the -D 
option. 

TMPDIR=/tmp 

Directory in which temporary files are kept. 

The values of the default settings can be changed to reflect the local 
system configuration. If /etc/default/imagen does not exist or cannot 
be read, the above default values are used. 



Files 

tmpdirl&vi?????? 

Temporary file used to hold the DVI output that dviimp processes. 
The value of tmpdir is set by TMPDIR in /etc/default/imagen. 

raster/240/* 

Raster images of host resident fonts. The default values for raster 
is specified by RASTER in /etc/default/imagen, and can be over- 
ridden by the -D option. 

/usr/bin/dviimp 

The DVI to imPRESS format conversion program. 



See Also 

dviimp(CT), imprint(C), ipr(C) 
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Notes 

The resolution of the IMAGEN printer is assumed to be 240 pixels per 
inch. 

"Font /version «" means this font file is not a version RAS-format 
file. Other diagnostics should be self-explanatory. 



Author 

IMAGEN Corporation. 
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Name 

join - Joins two relations. 

Syntax 

join [ options ] filel file2 



Description 

join forms, on the standard output, a join of the two relations specified 
by the lines of filel andfile2 . If filel is a dash (-), the standard input 
is used. 

Filel and file2 must be sorted in increasing ASCII collating sequence 
on the fields on which they are to be joined, normally the first in each 
line. 

There is one line in the output for each pair of lines in filel and filel 
that have identical join fields. The output line normally consists of 
the common field, then the rest of the line from filel , then the rest of 
the line from file! . 

Fields are normally separated by blank, tab or newline. In this case, 
multiple separators count as one, and leading separators are discarded. 

These options are recognized: 

-an In addition to the normal output, produces a line for each 

unpairable line in file n, where n is 1 or 2. 

-e s Replaces empty output fields by string s . 

-jn m Joins on the m\h field of file n. If n is missing, uses the 
mth field in each file. 

-o list Each output line comprises the fields specified in list, 
each element of which has the form n.m, where n is a file 
number and m is a field number. 

-tc Uses character c as a separator (tab character). Every 

appearance of c in a line is significant. 
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See Also 

awk(C), comm(C), sort(C) 

Notes 

With default field separation, the collating sequence is that of sort -b. 
With -t, the sequence is that of a plain sort. 
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Name 

kill - Terminates a process. 



Syntax 

kill [ -signo ] processid ... 



Description 

kill sends signal 15 (terminate) to the specified processes. This will 
normally kill processes that do not catch or ignore the signal. The 
process number of each asynchronous process started with & is 
reported by the shell (unless more than one process is started in a pipe- 
line, in which case the number of the last process in the pipeline is 
reported). Process numbers can also be found by using ps(C). 

For example, if process number is specified, all processes in the pro- 
cess group are signaled. 

The killed process must belong to the current user unless he is the 
super-user. 

If a signal number preceded by - is given as the first argument, that 
signal is sent instead of the terminate signal (see signal (S)). In partic- 
ular ' 'kill -9 ..." is a sure kill. 



See Also 

ps(C), sh(C), kill(S), signal(S) 
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Name 

1 - Lists information about contents of directory. 



Syntax 

1 [ -ACFRabcdfgilnopqrstu ] name ... 



Description 

For each directory argument, / lists the contents of the directory; for 
each file argument, / repeats its name and other requested information. 
The output is sorted alphabetically by default. When no argument is 
given, the current directory is listed. When several arguments are 
given, the arguments are first sorted appropriately, but file arguments 
appear before directories and their contents. Information is listed in 
the format of the "Is -1" command, which is identical to the / com- 
mand. This format and all provided switches are described in ls(C) 
and /c(C), to which should you should refer for a complete discussion 
of the capabilities of /. 



Files 

/etc/passwd Contains user IDs 
/etc/group Contains group IDs 



Notes 

Newline and tab are considered printing characters in filenames. 
The output device is assumed to be 80 columns wide. 
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Name 

last - indicate last logins of users and teletypes 
Syntax 

last [ -n limit ] [ -1 tty ] [ -v ] [ name ] 
DESCRIPTION 

Last checks the wtmp file, which records all logins and logouts for 
information about a user, a serial line or any group of users and lines. 
Arguments specify a user name and/or tty. 

last -1 ttyOl root 

would list all "root" sessions as well as all sessions on /dev/ttyOl. 
last prints the sessions of the specified users and ttys, including login 
name, the line used, the device name, the process ID, plus start time 
and elapsed time. 

last with no arguments prints a record of all logins and logouts, in 
reverse order. 

The options behave as follows: 

-n limit 

limits the report to n lines. 

-1 line 

specifies the tty. 

-v prints header (verbose option). 
Files 

/etc/wtmp login data base 

See Also 

finger(C), utmp(M), accton(ADM), acctcom(ADM), acct(F) 
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Name 

lc - Lists directory contents in columns. 



Syntax 

lc [ -lACFRabcdfgilmnopqrstux ] name ... 



Description 

lc lists the contents of files and directories, in columns. If name is a 
directory name, lc lists the contents of the directory; if name is a 
filename, lc repeats the filename and any other information requested. 
Output is given in columns and sorted alphabetically. If no argument 
is given, the current directory is listed. If several arguments are given, 
they are sorted alphabetically, but file arguments appear before direc- 
tories. 

Files that are not the contents of a directory being interpreted are 
always sorted across the page rather than down the page in columns. 
A stream output format is available in which files are listed across the 
page, separated by commas. The -m option enables this format. 

The options are: 

-1 Forces an output format with one entry per line. 

-A If not the root directory, this option displays all files that begin 
with "." (except "." and themselves). Otherwise, files are 
displayed normally. 

-C Forces columnar output, even if redirected to a file. 

-F Causes directories to be marked with a trailing ' '/' ' and executable 
files to be marked with a trailing "*". 

-R Recursively lists subdirectories. 

-a Lists all entries; "." and".." are not suppressed. 

-b Forces printing of nongraphic characters in the \ddd notation, in 
octal. 

-c Sorts by time of file creation, for use with -t option. 

-d If the argument is a directory, lists only its name, not its contents 
(mostly used with -1 to get status on directory). 
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-f Forces each argument to be interpreted as a directory and lists the 
name found in each slot. This option turns off -1, -t, -s, and -r, and 
turns on -a; the order is the order in which entries appear in the 
directory. 

-g The same as -1, except that the owner is not printed. 

-i Prints inode number in first column of the report for each file 
listed. 

-1 Lists in long format, giving mode, number of links, owner, group, 
size in bytes, and time of last modification for each file. If the file 
is a special file, the size field instead contains the major and minor 
device numbers. 

-m 

Forces stream output format. 

-n Same as the -1 switch, but the owner's user ID appears instead of 
the owner's name. If used in conjunction with the -g switch, the 
owner's group ID appears instead of the group name. 

-o The same as -1, except that the group is not printed. 

-p Pad output with spaces. 

-q Forces printing of nongraphic characters in filenames as the char- 
acter "?". 

-r Reverses the order of sort to get reverse alphabetic or oldest first as 
appropriate. 

-s Gives size in 512-byte blocks, including indirect blocks for each 
entry. 

-t Sorts by time modified (latest first) instead of by name, as is nor- 
mal. 

-u Uses time of last access instead of last modification for sorting (-t) 
or printing (-1). 

-x Forces columnar printing to be sorted across rather than down the 
page. 

The following are alternate invocations of the lc command: 
If Produces the same output as lc -F. 
Ir Produces the same output as lc -R. 
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lx Produces the same output as lc -x. 

The mode printed under the -1 option contains 1 1 characters. The first 
character is: 

If the entry is a plain file 

d If the entry is a directory 

b If the entry is a block-type special file 

c If the entry is a character-type special file 

p If the entry is a named pipe 

s If the entry is a semaphore 

m If the entry is shared data (memory) 

The next 9 characters are interpreted as 3 sets of 3 bits each. The first 
set refers to owner permissions; the next to permissions to others in 
the same user-group; and the last to all others. Within each set, the 3 
characters indicate permission respectively to read, to write, or to exe- 
cute the file as a program. For a directory, "execute" permission is 
interpreted to mean permission to search the directory for a specified 
file. The permissions are indicated as follows: 

r If the file is readable 

w If the file is writable 

x If the file is executable 

If the indicated permission is not granted 

The group-execute permission character is given as s if the file has 
set-group-ID mode; likewise the user-execute permission character is 
given as s if the file has set-user-ID mode. 

The last character of the mode (normally "x" or "-") is t if the 1000 
bit of the mode is on. See chmod(C) for the meaning of this mode. 

When the sizes of the files in a directory are listed, a total count of 
blocks, including indirect blocks, is displayed. 



Files 



/etc/passwd 



To get user IDs for "lc -o" 
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/etc/group To get group IDs for ' 'lc -g' ' 



Credit 

This utility was developed at the University of California at Berkeley 
and is used with permission. 



Notes 

Newline and tab are considered printing characters in filenames. The 
output device is assumed to be 80 columns wide. Column width 
choices are poor for terminals that can tab. 

This utility reports sizes in 512 byte blocks. On systems which use 
1024 byte blocks, this means a file of 500 bytes uses 2 blocks, lc -s 
will report 2 blocks used, rather than 1 block, since the file uses one 
system block of 1024 bytes. Refer to the machine(M) manual page 
for the block size used by your system. 
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Name 

line - Reads one line. 

Syntax 
line 

Description 

line copies one line (up to a newline) from the standard input and 
writes it on the standard output. It returns an exit code of 1 on end- 
of-file and always prints at least a newline. It is often used within 
shell files to read from the user's terminal. 

See Also 

gets(CP), sh(C) 
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LN(C) 



Name 

In - Makes a link to a file. 



Syntax 

In filel file2 

In filel ... directory 



Description 

A link is a directory entry referring to a file; the same file (together 
with its size, all its protection information, etc), may have several 
links to it. There is no way to distinguish a link to a file from its origi- 
nal directory entry. Any changes to the file are effective independent 
of the name by which the file is known. 

In the first case, In creates a link to the existing file, filel. The file2 
argument is a new name referring to the same file contents as filel. 

In the second case, directory is the location of a directory into which 
one or more links are created with corresponding file names. 

You cannot link to a directory or link across file systems. 



See Also 

cp(C), mv(C), rm(C) 
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Name 

lock - Locks a user's terminal. 



Syntax 

lock [-v] [ -number ] 



Description 

lock requests a password from the user, requests it again for verifica- 
tion, then locks the terminal until the password is reentered. If a 
-number is specified in the lock command, the terminal is automati- 
cally logged out and made available to another user after that number 
of minutes has passed. 

This command uses the file I etc I default! lock. This file has two entries: 

DEFLOGOUT = number 
MAXLOGOUT = number 

DEFLOGOUT specifies the default time in minutes a terminal will 
remain locked before the user is logged out. This default value is 
overridden if the -number option is used on the command line. If 
DEFLOGOUT and -number are not specified, the MAXLOGOUT 
value is used. 

MAXLOGOUT is the maximum number of minutes a user is permit- 
ted to lock a terminal. If a user attempts to lock a terminal for longer 
than this time, lock will issue a warning to the user that it is using the 
system maximum time limit. If DEFLOGOUT and -number and 
MAXLOGOUT are not specified, users are not logged out. 

DEFLOGOUT and MAXLOGOUT are configured by the system 
administrator to reflect the demand for terminals at the site. 

The lock may be terminated by killing the lock process. Only the 
superuser and the user who invoked lock may do so. 



Options 

-number Sets the time limit for lock to number of minutes, instead 
of the system default. 

-v Specifies verbose operation. 

Files 

/etc/default/lock 
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Notes 

The file I etc I default/ lock is shipped with the following default values: 

DEFLOGOUT=30 
MAXLOGOUT = 60 
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Name 

logname - Gets login name. 

Syntax 
logname 

Description 

logname returns the user's login name as found in letclutmp. If no 
login name is found, logname returns the user's user ID number. 

See Also 

env(C), id(C), getlogin(S), getuid(S), login(M), logname(S) 
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LP(C) 
Name 

lp, lpr, cancel - Send/cancel requests to lineprinter. 



LP(C) 



Syntax 

lp [options...] [name...] 
or 

lpr [options...] [name...] 
cancel [ request ID s ] [ printers ] 



Description 

lp causes the named files and associated information (collectively 
called a "request") to be printed by a lineprinter. lp and lpr are 
equivalent commands and may be used interchangeably. If no file 
names are mentioned, the standard input is assumed. The file name - 
stands for the standard input and may be supplied on the command 
line in conjunction with named files . The order in which files appear 
is the same order in which they will be printed. 

lp associates a unique request ID with each request and prints it on the 
standard output. This request ID can be used later to cancel (see can- 
cel) or find the status of the request (see lpstat{C)). 

The following options to lp may appear in any order and may be inter- 
mixed with file names: 

-c Makes copies of the files to be printed immediately when 

lp is invoked. Normally, files will not be copied, but will 
be linked whenever possible. If the -c option is not given, 
then the user should be careful not to remove any of the 
files before the request has been printed in its entirety; any 
changes made to the named files after the request is made 
but before it is printed will be reflected in the printed out- 
put. 

-ddest Chooses dest as the printer or class of printers to do the 
printing. If dest is a printer, then the request will be 
printed only on that specific printer. If dest is a class of 
printers, then the request will be printed on the first avail- 
able printer that is a member of the class. Under certain 
conditions (for example, printer unavailability or file space 
limitation), requests for specific destinations may not be 
accepted (see accept {C) and lpstat(C)). By default, dest is 
taken from the environment variable LPDEST (if it is set). 
Otherwise, a default destination (if one exists) for the com- 
puter system is used. Destination names vary between sys- 
tems (see lpstat(C)). 
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-m Sends mail (see mail(C)) after the files have been printed. 

By default, no mail is sent upon normal completion of the 
print request. 

-nnumber Prints number of copies of the output. The default is one. 

-ooption Specifies printer-dependent or class-dependent options. 

Several such options may be collected by specifying the -o 
key letter more than once. For more information about 



what is valid for options, see Ipadmin(ADM). 
-r Removes file after sending it. 

-s Suppresses messages from lp(C) such as "request id is 

-ttitle Prints title on the banner page of the output. 

-T Local printing option. Sends print job to printer attached to 

the terminal. 

-w Writes a message on the user's terminal after the files have 



been printed. If the user is not logged in, then mail is sent 
instead. 

The file /etc/default/lpd contains the setting of the variable 
BANNERS, whose value is the number of pages printed as a banner 
identifying each printout. This is normally set to either 1 or 2. 

Cancel cancels line printer requests that were made by the lp(C) com- 
mand. The command line arguments may be either request IDs (as 
returned by lp(C)) or printer names (for a complete list, use lpstat(C)). 
Specifying a request ID cancels the associated request even if it is 
currently printing. Specifying a printer cancels the request which is 
currently printing on that printer. In either case, the cancellation of a 
request that is currently printing frees the printer to print its next 
available request. User's identification and accounting data spool area 
contains BANNERS setting. 



Files 

/etc/passwd 

/usr/spoolAp/* 

/etc/default/lpd 



See Also 

enable(C), lpstat(C), mail(C), accept(C), lpadmin(ADM), 
lpsched(ADM) 
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Notes 

lp and Ipr only print files that are publicly readable. The file's direc- 
tory and all directories in the path must also be publicly readable. The 
following are two possible workarounds: 

pr filename I lp 

cat filename I lp 
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Name 

lpr - Sends files to the lineprinter queue for printing. 

Syntax 

lpr [ option ... ] [ name ... ] 

Description 

lpr causes the named files to be queued for printing on a lineprinter. 
If no names appear, the standard input is assumed; thus lpr may be 
used as a filter. 

The following options may be given (each as a separate argument and 
in any order) before any filename arguments: 

-c Makes a copy of the file and prints the copy and not the origi- 
nal. Normally files are linked whenever possible. 

-r Removes the file after sending it. 

-m When printing is complete, reports that fact by mail(C). 

-n Prints number of copies of output. 

The file /etc/default/lpd contains the setting of the variable 
BANNERS, whose value is the number of pages printed as a banner 
identifying each printout. This is normally set to either 1 or 2. 

Files 

/etc/passwd User's identification and accounting data 

/usrAib/lpd Lineprinter daemon 

/usr/spool/lpd/* Spool area 

/etc/default/lpd Contains BANNERS default setting 

/etc/lpopen On some systems - sets modes on a serial line 

See Also 

banner(C), lp(C) 
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Notes 



Once a file has been queued for printing, it should not be changed or 
deleted until printing is complete. If you want to alter the contents of 
the file or to remove the file immediately, use the -c option to force Ipr 
to make its own copy of the file. 
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Name 

lprint - print to a printer attached to the user's terminal 

Syntax 

lprint [ - ]file 

Description 

Iprint(C) accepts a filename to print or - to read from the keyboard. If 
the terminal has local printing abilities, it will then print the file to a 
printer attached to the printer port of the terminal. 

This command uses the file /etc/termcap. 
Options 

Tells lprint to use the standard input for printing. 

Files 

/etc/termcap 

Notes 

The only terminals currently supported with entries in /etc/termcap are 
Tandy's DT-100 and DT-1, and Hewlett-Packard's HP-92. 

To add attached printer capability to the termcap file for a different 
terminal, add entries for PN (start printing) and PS (end printing) with 
the appropriate control or escape characters for your terminal. 

Terminal communications parameters (such as baud rate and parity) 
must be set up on the terminal by the user. 

See Also 

"Using Printers" in the XENIX System Administrator's Guide. 
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Name 

lpstat - prints lineprinter status information 



Syntax 

lpstat [options ...] 



Description 

lpstat prints information about the current status of the lineprinter sys- 
tem. 

If no options are given, then lpstat prints the status of all requests 
made to lp(C) by the user. Any arguments that are not options are 
assumed to be request IDs (as returned by Ip). lpstat prints the status 
of these requests. Options may appear in any order and may be 
repeated and intermixed with other arguments. Some of the following 
options may be followed by list which can be in one of two forms: a 
list of items separated from one another by a comma, or a list of items 
enclosed in double quotes and separated from one another by a comma 
and/or one or more spaces. For example: 

-u"userl, user2, user3" 

The omission of a list following such options causes all information 
relevant to the option to be printed, for example: 

lpstat -o 

prints the status of all output requests. 

-a[list] Prints acceptance status (with respect to Ip) of destinations 
for requests. List is a list of intermixed printer names and 
class names. 

-c[ list ] Prints class names and their members. List is a list of class 
names. 

-d Prints the system default destination for Ip . 

-o[list] Prints the status of output requests. List is a list of inter- 
mixed printer names, class names, and request IDs. 

-p[list] Prints the status of printers. List is a list of printer names. 

-r Prints the status of the lineprinter scheduler, Ipsched. 
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-s 



Prints a status summary, including the status of the line- 
printer scheduler, the system default destination, Prints a 
status summary, including the system default destination, a 
list of class names and their members, and a list of printers 
and their associated devices. 



-t 



Prints all status information. 



-u[list] Prints status of output requests for users. List is a list of 
login names. 

-v[ list ] Prints the names of printers and the pathnames of the dev- 
ices associated with them. List is a list of printer names. 

Files 

/usr/spootylp/* 

See Also 

enable(C), lp(C) 
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Name 

Is - Gives information about contents of directories. 



Syntax 

Is [ -ACFRabcdfgilmnopqrstux ] [ names ] 



Description 

For each directory named, Is lists the contents of that directory; for 
each file named, Is repeats its name and any other information 
requested. By default, the output is sorted alphabetically. When no 
argument is given, the current directory is listed. When several argu- 
ments are given, the arguments are first sorted appropriately, but file 
arguments are processed before directories and their contents. 

There are three major listing formats. The default format is to list one 
entry per line, the -C and -x options enable multi-column formats, and 
the -m option enables stream output format in which files are listed 
across the page, separated by commas. In order to determine output 
format for the -C, -x, and -m options, Is uses an environment variable, 
COLUMNS, to determine the number of character positions available 
on one output line. If this variable is not set, the termcap database is 
used to determine the number of columns, based on the environment 
variable TERM. If this information cannot be obtained, 80 columns 
are assumed. 

There are many options: 

-A List all entries; entries whose name begin with a period (.) are 
listed. Does not list current directory (.) and directory above 
(..). 

-a Lists all entries; entries whose name begin with a period (.) are 
listed. 

-R Recursively lists subdirectories encountered. 

-d If an argument is a directory, lists only its name (not its con- 
tents); often used with -1 to get the status of a directory. 

-C Multi-column output with entries sorted down the columns. 

-x Multi-column output with entries sorted across rather than down 
the page. 

-m Stream output format. 
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-1 Lists in long format, giving mode, number of links, owner, 
group, size in bytes, and time of last modification for each file 
(see below). If the file is a special file, the size field will contain 
the major and minor device numbers, rather than a size. 

-n The same as -1, except that the owner's UID and group's GID 
numbers are printed, rather than the associated character strings. 

-o The same as -1, except that the group is not printed. 

-g The same as -1, except that the owner is not printed. 

-r Reverses the order of sort to get reverse alphabetic or oldest 
first, as appropriate. 

-t Sorts by time modified (latest first) instead of by name. 

-u Uses time of last access instead of last modification for sorting 
use with the -t option. 

-c Uses time of last modification of the inode (file created, mode 
changed, etc.) for sorting use with -t option. 

-p Puts a slash (/) after each filename if that file is a directory. 

-F Puts a slash (/) after each filename if that file is a directory and 
puts an asterisk (*) after each filename if that file is executable. 

-b Forces printing of non-graphic characters to be in the octal \ddd 
notation. 

-q Forces printing of non-graphic characters in file names as the 
character (?). 

-i For each file, prints the inode number in the first column of the 
report. 

-s Gives size in blocks, including indirect blocks, for each entry. 

-f Forces each argument to be interpreted as a directory and lists 
the name found in each slot. This option turns off -1, -t, -s, and - 
r, and turns on -a; the order is the order in which entries appear 
in the directory. 

The mode printed under the -1 option consists of 1 1 characters. The 
first character is: 

If the entry is an ordinary file. 

d If the entry is a directory. 
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b If the entry is a block special file. 

c If the entry is a character special file. 

p If the entry is a named pipe. 

s If the entry is a semaphore. 

m If the entry is a shared data (memory) file. 

The next 9 characters are interpreted as 3 sets of 3 bits each. The first 
set refers to the owner's permissions; the next to permissions of others 
in the user-group of the file; and the last to all others. Within each set, 
the 3 characters indicate permission to read, to write, and to execute 
the file as a program, respectively. For a directory, "execute" permis- 
sion is interpreted to mean permission to search the directory for a 
specified file. 

The permissions are indicated as follows: 

r If the file is readable. 

w If the file is writable. 

x If the file is executable. 

If the indicated permission is not granted. 

The group-execute permission character is given as s if the file has 
set-group-ID mode; likewise, the user-execute permission character is 
given as s if the file has set-user-ID mode. The last character of the 
mode (normally x or -) is t if the 1000 (octal) bit of the mode is on; see 
chmodiC) for the meaning of this mode. The indications of set-ID and 
1000 bit of the mode are capitalized if the corresponding execute per- 
mission is not set. 

When the sizes of the files in a directory are listed, a total count of 
blocks including indirect blocks is printed. 



Files 



/etc/passwd 



Gets user IDs for Is -1 and Is -o 



/etc/group 



Gets group IDs for Is -1 and Is -g 



/etc/termcap/ : 



Gets terminal information 



See Also 



chmod(C), find(C), 1(C), lc(C), termcap(C) 
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Notes 

Newline and tab are considered printing characters in filenames. 

Unprintable characters in filenames may confuse the columnar output 
options. 

This utility reports sizes in 512 byte blocks. Systems which define a 
block as 1024 characters, "round-off' the size of files containing 511 
or fewer bytes to 1 block. Is -s interprets 1 block from a 1024 byte 
block system as 2 of its own 512 byte blocks. Thus a 500 byte file is 
interpreted as 2 blocks rather than 1. Refer to the machine(M) 
manual page for the block size used by your system. 
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Name 

mail - Sends, reads or disposes of mail. 



Syntax 

mail [[-uuser] [-f mailbox]] [-e] [-R] [-i] [users ...] 
mail [-s subject] [-i] [ user ...] 



Description 

mail is a mail processing system that supports composing of mes- 
sages, and sending and receiving of mail between multiple users. 
When sending mail, a user is the name of a user or of an alias assigned 
to a machine or to a group of users. 

Options include: 

-u user 

Tells mail to read the system mailbox belonging to the specified 
user. 

-f mailbox 

Tells mail to read the specified mailbox instead of the default 
user's system mailbox. 

-e Allows escapes from compose mode when input comes from a file. 

-R Makes the mail session "read-only" by preventing alteration of 
the mailbox being read. Useful when accessing system-wide mail- 
boxes. 

-i Tells mail to ignore interrupts sent from the terminal. This is use- 
ful when reading or sending mail over telephone lines where 
"noise" may produce unwanted interrupts. 

-s subject 

Specifies subject as the text of the Subject: field for the message 
being sent. 



Sending mail 

To send a message to one or more other people, invoke mail with 
arguments which are the names of people to send to. You are then 
expected to type in your message, followed by a Ctrl-D at the begin- 
ning of a line. 
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Reading Mail 

To read mail, invoke mail with no arguments. This will check your 
mail out of the system- wide directory so that you can read and dispose 
of the messages sent to you. A message header is printed out for each 
message in your mailbox The current message is initially the last num- 
bered message and can be printed using the print command (which 
can be abbreviated p). You can move among the messages much as 
you move between lines in ed, with the commands + and - moving 
backwards and forwards, and simple numbers typing the addressed 
message. 

If new mail arrives during the mail session, you can read in the new 
messages with the restart command. 

Note that you can configure your environment so that you are notified 
whenever new mail is sent to you. To do so, you would have to set the 
MAIL shell variable if you are using the Bourne shell or the mail 
shell variable if you are using the C-shell. For more information, see 
"The Shell" chapter of the XENIX User's Guide and csh(C) in the 
XENIX User's Reference. 

Disposing of Mail 

After examining a message, you can delete (d) the message or reply 
(r) to it. Deletion causes the mail program to forget about the mes- 
sage. This is not irreversible, the message can be undeleted (u) by 
giving its number, or the mail session can be aborted by giving the 
exit (x) command. Deleted messages will, however, disappear. 



Specifying Messages 

Commands such as print and delete often can be given a list of mes- 
sage numbers as arguments to apply to a number of messages at once. 
Thus "delete 1 2" deletes messages 1 and 2, while "delete 1-5" 
deletes messages 1 through 5. The special name "*" addresses all 
messages, and "$" addresses the last message; thus the command top 
which prints the first few lines of a message could be used in "top *" 
to print the first few lines of all messages. 



Replying to or Originating Mail 

You can use the reply command to set up a response to a message, 
sending it back to the person who sent it. Then you can enter in the 
text of the reply, and press Ctrl-D to send it. While you are composing 
a message, mail treats lines beginning with a tilde (~) as special. For 
instance, typing "~m" alone on a line, places a copy of the current 
message into the response, right shifting it by one tabstop. Other 
escapes set up subject fields, add and delete recipients to the message, 
and allow you to escape to an editor to revise the message or to a shell 
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to run some commands. (These options are given in the summary 
below.) 



Ending a Mail Session 

You can end a mail session with the quit (q) command. Messages that 
have been examined go to your mbox file unless they have been 
deleted, in which case they are discarded. Unexamined messages go 
back to the post office. The -f option causes mail to read in the con- 
tents of your mbox (or the specified file) for processing; when you 
quit, mail writes undeleted messages back to this file. The -i option 
causes mail to ignore interrupts. 



Using Aliases and Distribution Lists 

It is also possible to create a personal distribution list. For instance, 
you can send mail to "cohorts" and have it go to a group of people. 
Such lists can be defined by placing a line like 

alias cohorts bill bob barry bobo betty beth bobbi 

in the file .mailrc in your home directory. The current list of such 
aliases can be displayed by the alias (a) command in mail. System- 
wide distribution lists can be created by editing /usr/lib/mail/aliases, 
see aliases (M); these are kept in a slightly different syntax. In mail 
you send, personal aliases will be expanded in mail sent to others so 
that they will be able to reply to the recipients. System-wide aliases 
are not expanded when the mail is sent, but any reply returned to the 
machine will have the system-wide alias expanded. 

mail has a number of options which can be set in the .mailrc file to 
alter its behavior; thus "set askcc" enables the "askcc" feature. 
(These options are summarized below.) 

Summary 

Each mail command is entered on a line by itself, and may take argu- 
ments following the command word. The command need not be 
entered in its entirety; the first command which matches the typed 
prefix is used. For the commands that take message lists as argu- 
ments; if no message list is given, then the next message forward that 
satisfies the command's requirements is used. If there are no messages 
forward of the current message, the search proceeds backwards, and if 
there are no messages at all, mail types "No applicable messages" 
and aborts the command. 

Goes to the previous message and prints it out. If given 
a numeric argument n, goes to the nth previous mes- 
sage and prints it. 
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RETURN 

? 

t 



$ 

alias 



Alias users 
cd 

delete 
dp 

echo path 
edit 

exit 

file 



Goes to the next message and prints it out. If given a 
numeric argument n, goes to the nth next message and 
prints it. 

Goes to the next message and prints it out. 
Prints a brief summary of commands. 
Executes the shell command which follows. 
Prints out the current message number. 
Prints out the first message. 
Prints out the last message. 

(a) With no arguments, prints out all currently-defined 
aliases. With one argument, prints out that alias. With 
more than one argument, adds the users named in the 
second and later arguments to the alias named in the 
first argument. 

Prints system- wide list of aliases for users. At least one 
user must be specified. 

(c) Changes the user's working directory to that 
specified, if given. If no directory is given, then 
changes to the user's login directory. 

(d) Takes a list of messages as an argument and marks 
them all as deleted. Deleted messages are not retained 
in the system mailbox after a quit, nor are they avail- 
able to any command other than the undelete command. 

Deletes the current message and prints the next mes- 
sage. If there is no next message, mail says "no more 
messages." 

Expands shell metacharacters. 

(e) Takes a list of messages and points the text editor at 
each one in turn. On return from the editor, the message 
is read back in. 

(x) Effects an immediate return to the shell without 
modifying the user's system mailbox, his mbox file, or 
his edit file in -f . 

(fi) Prints the name of the file mail is reading. If it is a 
mailbox, the name of the owner is returned. 
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forward (f) Forwards the current message to the named users. 

Current message is indented within forwarded message. 

Forward (F) Forwards the current message to the named users. 

Current message is not indented within forwarded mes- 
sage. 

headers (h) Lists the current range of headers, which is an 18 
message group. If a "+" argument is given, then the 
next 18 message group is printed, and if a "-" argu- 
ment is given, the previous 18 message group is 
printed. Both "+" and "-" may take a number to view 
a particular window. If a message-list is given, it prints 
the specified headers. 

hold (ho) Takes a message list and marks each message 

therein to be saved in the user's system mailbox instead 
of in mbox. Use only when the switch autombox is set. 
Does not override the delete command. 

list Prints list of mail commands. 

Ipr (1) Prints out each message in a message-list on the 

lineprinter. 

mail (m) Takes as arguments login names and distribution 

group names and sends mail to those people. 

mbox (mb) Marks messages in a message list so that they are 

saved in the user mailbox after leaving mail. 

move mesg-list mesg-num 

Places the messages specified in mesg-list after the 
message specified in mesg-num. If mesg-num is 0, 
mesg-list moves to the top of the mailbox. 

next (n like + or RETURN) Goes to the next message in 

sequence and prints it. With an argument list, types the 
next matching message. 

print (p) Prints out each message in a message-list on the ter- 

minal display. 

quit (q) Terminates the session, retaining all undeleted, 

unsaved messages in the system mailbox and removing 
all other messages. Files marked with a star (*) are 
saved; files marked with an "M" are saved in the user 
mailbox. If new mail has arrived during the session, 
the message "You have new mail" is given. If given 
while editing a mailbox file with the -f flag, then the 
mailbox file is rewritten. The user returns to the shell, 
unless the rewrite of the mailbox file fails, in which 
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case the user can escape with the exit command. 

reply (r) Takes a message list and sends mail to each mes- 

sage author. The default message must not be deleted. 

Reply (R) Takes a message list and sends mail to each mes- 

sage author and each member of the message just like 
the mail command. The default message must not be 
deleted. 

restart Reads in messages that arrived during the current mail 

session. 

save (s) Takes a message list and a filename and appends 

each message in turn to the end of the file. The 
filename, in quotation marks, followed by the line 
count and character count is echoed on the user's termi- 
nal. 

set (se) With no arguments, prints all variable values. Oth- 

erwise, sets option. Arguments are of the form 
"option=value" or "option". 

shell (sh) Invokes an interactive version of the shell. 

size (si) Takes a message list and prints out the size in char- 

acters of each message. 

source (so) Reads mail commands from the file given as its 

only argument. 

string string mesg-list 

Searches for string in mesg-list. If no mesg-list is 
specified, all undeleted messages are searched. Case is 
ignored in search. 

top (t) Takes a message list and prints the top few lines of 

each. The number of lines printed is controlled by the 
variable toplines and defaults to six. 

undelete (u) Takes a message list and marks each one as not 
being deleted. 

unset (uns) Takes a list of option names and discards their 

remembered values; the inverse of set. 

visual (v) Takes a message list and invokes vi on each mes- 

sage. 

whois Looks up a list of target mail recipients and prints the 

real names or descriptions of each recipient. If the first 
character of the first argument is alphabetic, the 
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arguments are looked up without change. Otherwise, 
the arguments are assumed to be a message list, in the 
format specified in the Mail User's Guide. For each 
message in the list, the "From" person is extracted 
from the header and added to the list of users to be 
searched. 

If a target mail recipient contains a machine and user 
name, nothing is printed. If it is a private alias, 
"private alias" is printed. If it is a global alias, the 
name or description of the recipient is printed (contents 
of the $n field in the alias file). If all of the above fail, 
the user is looked up in /etc/passwd; if the user is a 
local user, "local user" is printed. Finally, if none of 
the above tests and searches succeed, "unknown" is 
printed. 

write filename 

(w) Saves the body of the message in the named file. 

Here is a summary of the compose escapes, which are used when com- 
posing messages to perform special functions. Compose escapes are 
only recognized at the beginning of lines. 

"string Inserts the string of text in the message prefaced by a 
single tilde (~). If you have changed the escape charac- 
ter, then you should double that character instead. 

~? Prints out help for compose escapes. 

Same as Ctrl-D on a new line. 

~\cmd Executes the indicated shell command, then returns to 

the message. 

" | cmd Pipes the message through the command as a filter. If 

the command gives no output or terminates abnormally, 
retains the original text of the message. 

"_ mail-command 

Executes a mail command, then returns to compose 
mode. 

": mail-command 

Executes a mail command, then returns to compose 
mode. 

"alias Prints list of private aliases 

"alias aliasname 

Prints names included in private aliasname. 
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"Alias users 

"b name ... 

"c name ... 

"cc name ... 
"d 

"e 
"h 

"m mesg-list 
"M mesg-list 
"P 

"Print 

"q 



MAIL (C) 



Performs aliasing by first examining private aliases and 
then system-wide aliases using all three global alias 
files (aliases.hash, faliases, and maliases). Only the 
final result is printed (non-local mail recipients will 
have the complete delivery path printed). The user list 
is taken from header fields. 

Performs aliasing by first examining private aliases and 
then system-wide aliases using all three global alias 
files (aliases.hash, faliases, and maliases). Only the 
final result is printed (non-local mail recipients will 
have the complete delivery path printed). At least one 
user must be specified. 

Adds the given names to the list of blind carbon copy 
recipients. 

Adds the given names to the list of carbon copy reci- 
pients. 

Same as ~c above. 

Reads the file dead. letter from your home directory into 
the message. 

Invokes the text editor on the message collected so far. 
After the editing session is finished, you may continue 
appending text to the message. 

Edits the message header fields by typing each one in 
turn and allowing the user to append text to the end or 
modify the field with the current terminal erase and kill 
characters. 

Reads the named messages into the message buffer, 
shifted right one tab. If no messages are specified, 
reads the current message. 

Reads the named messages into the message buffer, 
with no indentation. If no messages are specified, reads 
the current message. 

Prints out the messages collected so far, prefaced by the 
message header fields. 

Prints the real names or descriptions (in parentheses) 
after each recipient in a header field. 

Aborts the message being sent, copying the message to 
dead.letter in your home directory if save is set. 
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"r filename Reads the named file into the message buffer. 
"Return name 

Adds the given names to the Return-receipt-to field. 

"s string Causes the named string to become the current subject 
field. 

"t name ... Adds the given names to the direct recipient list. 

"v Invokes a visual editor (defined by the VISUAL option) 

on the message buffer. After you quit the editor, you 
may resume appending text to the end of your message. 

"w filename Writes the body of the message to the named file. 

Options are controlled with the set and unset commands. An option 
may be either a switch, in which case it is either on or off, or a string, 
in which case the actual value is of interest. The switch options 
include the following: 

askcc Causes you to be prompted for additional carbon 

copy recipients at the end of each message. 
Responding with a newline indicates your satisfac- 
tion with the current list. 

asksubject Causes mail to prompt you for the subject of each 

message you send. If you respond with simply a 
newline, no subject field is sent. 

autombox Causes all examined messages to be saved in the 

user mailbox unless deleted or saved. 

autoprint Causes the delete command to behave like dp - 

thus, after deleting a message, the next one will be 
entered automatically. 

chron Causes messages to be displayed in chronological 

order. 

dot Permits use of dot (.) as the end of file character 

when composing messages. 

execmail Causes the underbar prompt to return before mail is 

finished being sent. This frees the user to continue 
while mail performs mailing functions in back- 
ground. 

ignore Causes interrupt signals from your terminal to be 

ignored and echoed as at-signs (@). 
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mchron Causes messages to be listed in numerical order 

(most recently received first), but displayed in chro- 
nological order. 

Usually, when a group is expanded that contains the 
sender, the sender is removed from the expansion. 
Setting this option causes the sender to be included 
in the group. 

Prevents aborted messages from being appended to 
the file dead.letter in your home directory on 
receipt of two interrupts (or a ~q). 

Suppresses the printing of the version header when 
first invoked. 

Causes each target mail recipient to be verified in 
the manner described in the whois command. This 
option permits errors made while composing mes- 
sages to be corrected or ignored. 

The following options have string values: 

EDITOR Pathname of the text editor to use in the edit com- 

mand and ~e escape. If not defined, then a default 
editor (Ibinled) is used. 

SHELL Pathname of the shell to use in the ! command and 

the ~! escape. A default shell (Ibinlsh) is used if this 
option is not defined. 

VISUAL Pathname of the text editor (Ibinlvi) to use in the 

visual command and ~v escape. 

escape If defined, the first character of this option gives the 

character to use in the place of the tilde (~) to 
denote escapes. 

page=n Specifies the number of lines (n) to be printed in a 

"page" of text when displaying messages. 

record If defined, gives the pathname of the file used to 

record all outgoing mail. If not defined, then outgo- 
ing mail is not saved. 

toplines If defined, gives the number of lines of a message to 

be printed out with the top command; normally, the 
first six lines are printed. 



metoo 

nosave 

quiet 
verify 
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Files 

/usr/spool/mail/* 
/usr/ftame/dead.letter 

/usr/flame/mbox 
/usr/name/.mailrc 
/usr/lib/mail/aliases 
/usr/lib/mail/ aliases .hash 
/usr/lib/mail/faliases 

/usr/lib/mail/maliases 

/usr/lib/mail/mailhelp.cmd 

/usr/lib/mail/mailhelp.esc 

/usr/lib/mail/mailhelp.set 

/usr/lib/mail/mailrc 

/usr/bin/mail 

See Also 

aliases(M), aliashash(ADM), 
XENIX User's Guide. 

Credit 
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System mailboxes 

File where undeliverable mail is depo- 
sited 

Your old mail 

File giving initial mail commands 

System-wide aliases 

System-wide alias database 

Forwarding aliases for the local 
machine 

Machine aliases 

Help file 

Help file 

Help file 

System initialization file (defaults) 
The mail command 

netutil(ADM) Chapter 3, "Mail", in the 



This utility was developed at the University of California at Berkeley 
and is used with permission. 
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Name 

mesg - Permits or denies messages sent to a terminal. 

Syntax 

mesg [ n ] [ y ] 

Description 

mesg with argument n forbids messages via write (C) by revoking 
nonuser write permission on the user's terminal, mesg with argument 
y reinstates permission. All by itself, mesg reports the current state 
without changing it. 

Files 

/dev/tty* 

See Also 

write(C) 

Diagnostics 

Exit status is if messages are receivable, 1 if not, 2 on error. 
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Name 

mkdir - Makes a directory. 

Syntax 

mkdir dirname ... 

Description 

mkdir creates directories. The standard entries "dot" (.), for the 
directory itself, and "dot dot" (..), for its parent, are made automati- 
cally. 

mkdir requires write permission in the parent directory. The permis- 
sions assigned to the new directory are modified by the current file 
creation mask set by umask{C). 

See Also 

rmdir(C), umask(C) 

Diagnostics 

mkdir returns exit code if all directories were successfully made; 
otherwise, it prints a diagnostic and returns nonzero. 
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Name 

mknod - Builds special files. 



Syntax 

/etc/mknod name [ c ] [ b ] major minor 
/etc/mknod name p 
/etc/mknod name s 
/etc/mknod name m 



Description 

mknod makes a directory entry and corresponding inode for a special 
file. The first argument is the name of the entry. In the first case, the 
second argument is b if the special file is block- type (disks, tape) or c 
if it is character-type (other devices). The last two arguments are 
numbers specifying the major device type and the minor device (e.g., 
unit, drive, or line number), which may be either decimal or octal. 

The assignment of major device numbers is specific to each system. 
Major device numbers can be found in the system source file c.c. 

mknod can also be used to create named pipes with the p option; 
semaphores with the s option; and shared data (memory) with the m 
option. 

Only the super-user can use the first form of the syntax. 



System Compatibility 

The s and m options can only be used to create XENIX version 3.0 
semaphores and shared data, not XENIX System V semaphores and 
shared data. 



See Also 

mknod(S) 
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Name 



mnt - mount a filesystem 



Syntax 

/etc/mnt [ -urat ] [ directory ] 
/etc/umnt directory 



Description 

mnt allows users other than the super-user to access the functionality 
of the mount(ADM) command to mount selected filesy stems. The 
super-user can define how and when a filesystem mount is permitted 
via special entries in the I etcl default/ filesys file. 

The filesystem requirements are the same as defined for mount(ADM). 

umnt removes the removable filesystem previously mounted at the 
mount point directory . 

mnt is invoked from letclrc with the -r and possibly the -a flag to 
mount filesystems when the system comes up multi-user. The -a flag 
is used when the system has autobooted. Neither of these flags should 
be specified during normal use. 

The -t flag displays the contents of /etc/default/filesys. 

The -u flag forces mnt to behave like umnt. 



The following options can be defined in the I etcl default! filesys entry 
for a filesystem: 



mom\tdvc=l directory The directory the filesystem is to be mounted 



Options 



bdev=/dev /device 



Name of block device associated with the 
filesystem. 



cdev=/dev /device 



Name of character (raw) device associated 
with the filesystem. 



on. 



de-sc— name 



A string describing the filesystem. 
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passwd=string An optional password prompted for at mount 

request time. Cannot be a simple string; must 
be in the format of /etc/pass wd. (See Notes.) 

fsck=yes, no, dirty, prompt 

If yes/no, tells explicitly whether or not to run 
fsck. If dirty, fsck is run only if the filesystem 
requires cleaning. If prompt, the user is 
prompted for a choice. If no entry is given, 
the default value is dirty. 

fsckflags^ags Any flags to be passed to fsck. 

rcfsck=yes, no, dirty, prompt 

Similar to fsck entry, but only applies when 
the -r flag is passed. M000 

maxcleans=« The number of times to repeat cleaning of a 

dirty filesystem before giving up. If 
undefined, default is 4. 

mount=yes, no, prompt 

If yes or no, users are allowed or disallowed 
to mount the filesystem, respectively. If 
prompt, the user is queried to mount the 
filesystem. 

rcmount=yes, no, prompt 

If yes, the filesystem is mounted by letclrc 
when the system comes up multiuser. If no, 
the filesystem is never mounted by letclrc. 
With prompt, a query is displayed at boot 
time to mount the filesystem. 

Any flags to be passed to mount. 

Indicates whether any prepcmd entry should 
always be executed, never executed, or exe- 
cuted as specified by user. 

An arbitrary shell command to be invoked 
immediately following password check and 
prior to running fsck. 

Indicates whether an initcmd entry should 
always be executed, never be executed, or 
executed as specified by user. 

An optional, arbitrary shell command to be 
invoked immediately following a successful 
mount. 



mountflags=/7<2g5 
prep=yes, no, prompt 

pre.pcmd=command 

init=yes, no, prompt 

imtcmd=c ommand 
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Any entries containing spaces, tabs, or newlines must be contained in 
double quotes ("). 

The only mandatory entries in /etc/ default/ filesys are bdev and 
mountdir. The prepcmd and initcmd options can be used to execute 
another command before or after mounting the filesystem. For exam- 
ple, initcmd could be defined to send mail to root whenever a given 
filesystem is mounted. 

When invoked without arguments, mnt attempts to mount all filesys- 
tems that have the entries mount=yes or mount=prompt. 



Examples 

The following is a sample I etc/ default/ filesys file: 

bdev=/dev/root cdev=/dev/rroot mountdir=/ \ 
desc="The Root Filesystem" rcmount=no mount=no 

bdev=/dev/u cdev=/dev/ru mountdir=/u rcmount=yes \ 
fsckflags=-y desc="The User Filesystem" 

bdev=/dev/x cdev=/dev/rx mountdir=/u rcmount=no \ 
mount=yes fsckflags=-y desc="The Extra Filesystem" 

Of the examples above, only Ix is mountable by the user. 



See Also 

mount(ADM), default(M) 
Diagnostics 

mnt will fail if the filesystem to be mounted is currently mounted 
under another name. 

Busy filesystems cannot be dismounted with umnt. A filesystem is 
busy if it contains an open file or if a user's present working directory 
resides within the filesystem. 



Some degree of validation is done on the filesystem, however it is gen- 
erally unwise to mount corrupt filesystems 



Files 



/etc/ def ault/f ilesy s 



Filesystem data 



Notes 
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In order to create a password for a filesystem, you must create a 
dummy account in letclpasswd and define a password for it. You can 
then edit the letclpasswd file and transfer the encrypted password into 
the password entry for the filesystem in letcldefau.lt/filesys. 
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Name 

more - Views a file one screen full at a time. 



Syntax 

more [ -cdflrsuw ][-«][ +linenumber ] [ +/pattern ] [ name ... ] 



Description 

This filter allows examination of a continuous text one screen full at a 
time. It normally pauses after each full screen, displaying: 

~More~ 

at the bottom of the screen. If the user then presses a carriage return, 
one more line is displayed. If the user presses the SPACE bar, another 
full screen is displayed. Other possibilities are described below. 

The command line options are: 

-n An integer which is the size (in lines) of the window which more 
will use instead of the default. 

-c more draws each page by beginning at the top of the screen and 
erasing each line just before it draws on it. This avoids scrolling 
the screen, making it easier to read while more is writing. This 
option is ignored if the terminal does not have the ability to clear 
to the end of a line. 

-d more prompts with the message "Hit space to continue, Rubout to 
abort" at the end of each full screen. This is useful if more is being 
used as a filter in some setting, such as a class, where many users 
may be inexperienced. 

-f This option causes more to count logical, rather than screen lines. 
That is, long lines are not folded. This option is recommended if 
nroff output is being piped through ul, since the latter may generate 
escape sequences. These escape sequences contain characters that 
would ordinarily occupy screen positions, but do not print when 
they are sent to the terminal as part of an escape sequence. Thus 
more may think that lines are longer than they actually are and fold 
lines erroneously. 

-1 Does not treat Ctrl-L (form feed) specially. If this option is not 
given, more pauses after any line that contains a Ctrl-L, as if the 
end of a full screen has been reached. Also, if a file begins with a 
form feed, the screen is cleared before the file is printed. 
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-s Squeezes multiple blank lines from the output, producing only one 
blank line. Especially helpful when viewing nroff output, this 
option maximizes the useful information present on the screen. 

-u Normally, more handles underlining, such as that produced by nroff 
in a manner appropriate to the particular terminal: if the terminal 
can perform underlining or has a stand-out mode, more outputs 
appropriate escape sequences to enable underlining or stand-out 
mode for underlined information in the source file. The -u option 
suppresses this processing. 

-r Normally, more ignores control characters that it does not interpret 
in some way. The -r option causes these to be displayed as X 
where "C" stands for any such character. 

-w Normally, more exits when it comes to the end of its input. With - 
w however, more prompts and waits for any key to be struck before 
exiting. 

+linenumber 

Starts up at linenumber. 

+/pattern 

Starts up two lines before the line containing the regular expres- 
sion pattern. 

more looks in the file /etc/termcap to determine terminal characteris - 
tics, and to determine the default window size. On a terminal capable 
of displaying 24 lines, the default window size is 22 lines. 

more looks in the environment variable MORE to preset any flags 
desired. For example, if you prefer to view files using the -c mode of 
operation, the shell command "MORE=-c" in the .profile file causes 
all invocations of more to use this mode. 

If more is reading from a file, rather than a pipe, a percentage is 
displayed along with the "--More--" prompt. This gives the fraction 
of the file (in characters, not lines) that has been read so far. 

Other sequences which may be entered when more pauses, and their 
effects, are as follows (i is an optional integer argument, defaulting to 
1): 

i <space> 

Displays / more lines, (or another full screen if no argument is 
given). 

Ctrl-D 

Displays 11 more lines (a "scroll"). If / is given, then the scroll 
size is set to / . 
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d Same as Ctrl-D. 

iz Same as entering a space except that i, if present, becomes the 
new window size. 

i s Skips i lines and displays a full screen of lines. 

i f Skips i full screens and displays a full screen of lines. 

qorQ 

Exits from more. 

= Displays the current line number. 

v Starts up the screen editor vi at the current line. Note that vi may 
not be available with your system. 

hor? 

Help command; Gives a description of all the more commands. 
i /expr 

Searches for the i th occurrence of the regular expression expr. If 
there are less than i occurrences of expr, and the input is a file 
(rather than a pipe), then the position in the file remains 
unchanged. Otherwise, a full screen is displayed, starting two 
lines before the place where the expression was found. The user's 
erase and kill characters may be used to edit the regular expres- 
sion. Erasing back past the first column cancels the search com- 
mand. 

in Searches for the /th occurrence of the last regular expression 
entered. 

' (Single quotation mark) Goes to the point from which the last 
search started. If no search has been performed in the current file, 
this command goes back to the beginning of the file. 

! command 

Invokes a shell with command. The characters % and ! in "com- 
mand" are replaced with the current filename and the previous 
shell command respectively. If there is no current filename, % is 
not expanded. The sequences "\%" and "\!" are replaced by 
"%" and "!" respectively. 

i :n 

Skips to the / th next file given in the command line (skips to last 
file if i doesn't make sense). 
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z:p 

Skips to the / th previous file given in the command line. If this 
command is given in the middle of printing out a file, more goes 
back to the beginning of the file. If i doesn't make sense, more 
skips back to the first file. If more is not reading from a file, the 
bell rings and nothing else happens. 

:f Displays the current filename and line number. 

:q or :Q 

Exits from more (same as q or Q). 

Repeats the previous command. 

The commands take effect immediately. It is not necessary to enter a 
carriage return. Up to the time when the command character itself is 
given, the user may enter the line kill character to cancel the numeri- 
cal argument being formed. In addition, the user may enter the erase 
character to redisplay the "~More~(xc%)" message. 

The terminal is set to noecho mode by this program so that the output 
can be continuous. What you enter will not show on your terminal, 
except for the slash (/) and exclamation (!) commands. 

If the standard output is not a teletype, more acts just like cat, except 
that a header is printed before each file (if there is more than one). 

A sample usage of more in previewing nroff output would be 

nroff -ms +2 doc.n I more -s 



Files 

/etc/termcap Terminal data base 

/usr/lib/more.help Help file 



See Also 

csh(CP), sh(C), environ(M) 



Credit 

This utility was developed at the University of California at Berkeley / 
and is used with permission. 
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Notes 

The vi and help options may not be available. 

Before displaying a file, more attempts to detect whether it is a non- 
printable binary file such as a directory or executable binary image. If 
more concludes that a file is unprintable, it refuses to print it. How- 
ever, more cannot detect all possible kinds of non-printable files. 
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Name 

mv - Moves or renames files and directories. 

Syntax 

mv [ -f ] filel file2 
mv [ -f ] file ... directory 

Description 

mv moves (changes the name of) filel to file2 . 

If file! already exists, it is removed before filel is moved. If file! has 
a mode which forbids writing, mv prints the mode (see chmodiS)) and 
reads the standard input to obtain a line. If the line begins with y, the 
move takes place; if not, mv exits. 

In the second form, one or more files are moved to the directory with 
their original filenames. 

No questions are asked when the -f option is given. 
mv refuses to move a file onto itself. 

mv can only rename directories, not physically move them. 
mvdir( ADM) should be used to move directories within a filesystem. 

See Also 

cp(C), chmod(S), copy(C) 

Notes 

If filel andfile2 lie on different file systems, mv must copy the file 
and delete the original. In this case the owner name becomes that of 
the copying process and any linking relationship with other files is 
lost. 
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Name 

newform - Changes the format of a text file. 



Syntax 

newform [-s] [-itabspec] [-otabspec] [-bn] [-en] [-pn] [-an] [-f] 
[-cchar] [-In] [file ... ] 



Description 

newform reads lines from the named files , or the standard input if no 
input file is named, and reproduces the lines on the standard output. 
Lines are reformatted in accordance with command line options in 
effect. 

Except for -s, command line options may appear in any order, may be 
repeated, and may be intermingled with files . Command line options 
are processed in the order typed. This means that option sequences 
like "-el 5 -160" will yield results different from "-160 -el 5". 
Options are applied to all files on the command line. 

-itabspec Input tab specification: expands tabs to spaces, according 
to the tab specifications given. Tabspec recognizes all tab 
specification forms described below. In addition, tabspec 
may be --, in which newform assumes that the tab 
specification is to be found in the first line read from the 
standard input. If no tabspec is given, tabspec defaults to 
-8. A tabspec of -0 expects no tabs; if any are found, they 
are treated as -1. 

-otabspec Output tab specification: replaces spaces by tabs, accord- 
ing to the tab specifications given. The tab specifications 
are the same as for -itabspec. If no tabspec is given, 
tabspec defaults to -8. A tabspec of -0 means that no 
spaces will be converted to tabs on output. 

-In Sets the effective line length to n characters. If n is not 

typed, -1 defaults to 72. The default line length without 
the -1 option is 80 characters. Note that tabs and back- 
spaces are considered to be one character (use -i to 
expand tabs to spaces). 

-bn Truncates n characters from the beginning of the line 

when the line length is greater than the effective line 
length (see -In). The default is to truncate the number of 
characters necessary to obtain the effective line length. 
The default value is used when -b with no n is used. This 
option can be used to delete the sequence numbers from a 
COBOL program as follows: 
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newform -11 -b7 file-name 

The option -11 must be used to set the effective line length 
shorter than any existing line in the file so that the -b 
option is activated. 

-en Truncates n characters from the end of the line. 

-ck Changes the prefix/append character to k. Default charac- 

ter for A: is a space (see options -p and -c). 

-pn Prefixes n characters (see -ck) to the beginning of a line 

when the line length is less than the effective line length. 
The default is to prefix the number of characters neces- 
sary to obtain the effective line length. 

-an Appends n characters to the end of a line. The default is 

to append the number of characters necessary to get the 
effective line length. 

-f Writes the tab specification format line on the standard 

output before any other lines are output. The tab 
specification format line which is printed will correspond 
to the format specified in the last -o option. If no -o 
option is specified, the line which is printed will contain 
the default specification of -8. 

-s Shears off leading characters on each line up to the first 

tab and places up to 8 of the sheared characters at the end 
of the line. If more than 8 characters (not counting the 
first tab) are sheared, the eighth character is replaced by a 
* and any characters to the right of it are discarded. The 
first tab is always discarded. 

An error message and program exit will occur if this 
option is used on a file without a tab on each line. The 
characters sheared off are saved internally until all other 
options specified are applied to that line. The characters 
are then added at the end of the processed line. 



Tabs 

Four types of tab specification are accepted for tabspec: "canned," 
repetitive, arbitrary, and file. The lowest column number is 1. For 
tabs, column 1 always refers to the leftmost column on a terminal, 
even one whose column markers begin at 0, e.g. the DASI 300, DASI 
300S, and DASI 450. 

The "canned" tabs are given as -code where code (and its meaning) is 
from the following list: 
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-a 1,10,16,36,72 

Assembler, IBM S/370, first format 

-a2 1,10,16,40,72 

Assembler, IBM S/370, second format 

-c 1,8,12,16,20,55 

COBOL, normal format 

-c2 1,6,10,14,49 

COBOL compact format (columns 1-6 omitted). Using 
this code, the first typed character corresponds to card 
column 7, one space gets you to column 8, and a tab 
reaches column 12. Files using this tab setup should 
include a format specification as follows: 
<:t-c2 m6 s66 d:> 

-c3 1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 

COBOL compact format (columns 1-6 omitted), with 
more tabs than COBOL -c2. This is the recommended 
format for COBOL. The appropriate format specification 
is: 

<:t-c3 m6 s66 d:> 

-f 1,7,11,15,19,23 
FORTRAN 

-p 1,5,9,13,17,21,25,29,33,37,41,45,53,57,61 
PL/I 

-s 1,10,55 

SNOBOL 

-u 1,12,20,44 

UNIVAC 1 100 Assembler 

In addition to these "canned" formats, three other types exist: 

-n A repetitive specification requests tabs at columns l+n, 

l+2*n, etc. Note that such a setting leaves a left margin of 
n columns on TermiNet terminals only. Of particular 
importance is the value -8: this represents the XENIX sys- 
tem "standard' ' tab setting, and is the most likely tab set- 
ting to found at a terminal. It is required for use with 
nroff(CT) -h option for high-speed output. Another spe- 
cial case is the value -0, implying no tabs at all. 

nl,n2,... The arbitrary format permits the user to type any chosen 
set of number, separated by commas, in ascending order. 
Up to 40 numbers are allowed. If any number (except the 
first one) is preceded by a plus sign, it is taken as an incre- 
ment to be added to the previous value. Thus, the tab lists 
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1,10,20,30 and 1,10,+10,+10 are considered identical. 

- -file 

If the name of a file is given, newform reads the first line 
of the file, searching for a format specification. If it finds 
one there, it sets the tab stops according to it, otherwise it 
sets them as -8. This type of specification may be used to 
make sure that a tabbed file is printed with correct tab set- 
tings. 

Any of the following may be used also; if a given flag occurs more 
than once, the last value given takes effect: 

-Ttype 

newform usually needs to know the type of terminal in 
order to set tabs and always needs to know the type to set 
margins, type is a name listed in term (CT). If no -T flag 
is supplied, newform searches for the $TERM value in 
the environment (see environ(M)). If no type can be 
found, newform tries a sequence that will work for many 
terminals. 

+mn The margin argument may be used for some terminals. It 

causes all tabs to be moved over n columns by making 
column n+1 the left margin. If +m is given without a 
value of n, the value assumed is 10. For a TermiNet, the 
first value in the tab list should be 1, or the margin will 
move even further to the right. The normal (leftmost) 
margin on most terminals is obtained by +m0. The mar- 
gin for most terminals is reset only when the +m flag is 
given explicitly. 



Example 

In the following example, newform converts a file named text with 
leading digits, one or more tabs, and text on each line to a file begin- 
ning with the text and the leading digits placed at the end of each line 
in column 73 (-s option). All tabs after the first one are expanded to 
spaces (-i option). To reach the line length of 72 characters (-1 option), 
spaces are appended to each line up to column 72 (-a option) or lines 
are truncated at column 72 (-e option). To reformat the sample file 
text in this manner, enter: 

newform -s -i -1 -a -e text 



Exit Codes 

- normal execution 

1 - for any error 
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See Also 

csplit(C) 



Diagnostics 



All diagnostics are fatal. 
usage: . . . 
not -s format 
can' t open file 
internal line too long 

tabspec in error 



tabspec indirection illegal 



newform was called with a bad option. 
There was no tab on one line. 
Self-explanatory. 

A line exceeds 512 characters after being 
expanded in the internal work buffer. 
A tab specification is incorrectly format- 
ted, or specified tab stops are not ascend- 
ing. 

A tabspec read from a file (or standard 
input) may not contain a tabspec referenc- 
ing another file (or standard input). 



Notes 

newform normally only keeps track of physical characters; however, 
for the -i and -o options, newform will keep track of backspaces in 
order to line up tabs in the appropriate logical columns. 

newform will not prompt the user if a tabspec is to be read from the 
standard input (by use of -i,~ or -o-). 

If the -f option is used, and the last -o option specified was "-o— " , 
and was preceded by either "-o— " or a "-i— " , the tab specification 
format line will be incorrect. 
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Name 

newgrp - Logs user into a new group. 



Syntax 

newgrp [ group ] 



Description 

newgrp changes the group identification of its caller. The same per- 
son remains logged in, and the current directory is unchanged, but cal- 
culations of access permissions to files are performed with respect to 
the new group ID. 

newgrp without an argument changes the group identification to the 
group in the password file. This changes the caller's group identifica- 
tion back to the original group. When most users log in, they are 
members of the group named group. 

If a group has a password, any user can become a member of that 
group by entering the password when prompted by newgrp. If a group 
does not have a password, a user can become a member of it only if 
the user is listed in /etc/group as a member of the group. 



Files 

/etc/group 
/etc/passwd 



See Also 

login(M), group(F) 



Notes 

There is no convenient way to enter a password into /etc/group. 

The newgrp command executes, but does not fork, a new shell. If your 
login shell is a C shell and you invoke newgrp , you will have to press 
CTRL-D when you wish to log out. Typing the csh (C) logout com- 
mand will result in an error message. Note also that the newgrp com- 
mand causes the csh history list to start again at 1 . 
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Name 

news - Print news items. 



Syntax 

news [ -a ] [ -n ] [ -s ] [ items ] 



Description 

news is used to keep the user informed of current events. By conven- 
tion, these events are described by files in the directory /usr/news. 

When invoked without arguments, news prints the contents of all 
current files in /usr/news, most recent first, with each preceded by an 
appropriate header, news stores the "currency" time as the modifica- 
tion date of a file named .news_time in the user's home directory (the 
identity of this directory is determined by the environment variable 
$HOME); only files more recent than this currency time are con- 
sidered "current." 

The -a option causes news to print all items, regardless of currency. 
In this case, the stored time is not changed. 

The -n option causes news to report the names of the current items 
without printing their contents, and without changing the stored time. 

The -s option causes news to report how many current items exist, 
without printing their names or contents, and without changing the 
stored time. 

All other arguments are assumed to be specific news items that are to 
be printed. 

If the INTERRUPT key is struck during the printing of a news item, 
printing stops and the next item is started. Another INTERRUPT 
within one second of the first causes the program to terminate. 



Files 

/usr/news/* 
$HOME/.news_time 
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See Also 

profile(M), environ(M). 
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Name 

nice - Runs a command at a different priority. 



Syntax 

nice [ -increment ] command [ arguments ] 



Description 

nice executes command with a lower CPU scheduling priority. Priori- 
ties range from to 39, where is the highest priority and 39 is the 
lowest. By default, commands have a "nice value" of 20. If an -incre- 
ment argument is given where increment is in the range 1-19, incre- 
ment is added to the default priority of 20 to produce a numerically 
higher priority, meaning a lower scheduling priority. If no increment 
is given, an increment of 10 to produce a priority of 30 is assumed. 

The super-user may run commands with priority higher than normal 
by using a double negative increment. For example, an argument of - 
-10 would decrement the default to produce a nice value of 10, which 
is a higher scheduling priority than the default of 20. 



See Also 

nohup(C), csh(C), nice(S) 



Diagnostics 

nice returns the exit status of the subject command. 



Notes 

An increment larger than 19 is equivalent to 19. 

Note also that this description of nice applies only to programs run 
under the Bourne Shell. The C-Shell has its own nice command, 
which is documented in csh(C). 
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Name 

nl - Adds line numbers to a file. 



Syntax 

nl [-htype] [-btype] [-ftype] [-vstart#] [-iincr] [-p] [-lnum] [-ssep] 
[-wwidth] [-nformat] file 



Description 

nl reads lines from the named file, or the standard input if no file is 
named, and reproduces the lines on the standard output. Lines are 
numbered on the left in accordance with the command options in 
effect. 

nl views the text it reads in terms of logical pages. Line numbering is 
reset at the start of each logical page. A logical page consists of a 
header, a body, and a footer section. Empty sections are valid. Dif- 
ferent line numbering options are independently available for header, 
body, and footer (e.g. no numbering of header and footer lines while 
numbering blank lines only in the body). 

The start of logical page sections is signaled by input lines containing 
nothing but the following character(s): 

Page Section Line Contents 

Header 

Body Vc 

Footer \: 

Unless signaled otherwise, nl assumes the text being read is in a sin- 
gle logical page body. 

Command options may appear in any order and may be intermingled 
with an optional filename. Only one file may be named. The options 
are: 

-btype Specifies which logical page body lines are to be num- 
bered. Recognized types and their meaning are: a, 
number all lines; t, number lines with printable text only; 
n, no line numbering; pstring, number only lines that con- 
tain the regular expression specified in string. Default 
type for logical page body is t (text lines numbered). 



May 16, 1988 



Page 1 



NL(C) 



NL(C) 



-htype Same as -btype except for header. Default type for logi- 
cal page header is n (no lines numbered). 

-itype Same as -btype except for footer. Default for logical page 
footer is n (no lines numbered). 

-p Does not restart numbering at logical page delimiters. 

-vstart# Start# is the initial value used to number logical page 
lines. Default is 1. 

-\incr Incr is the increment value used to number logical page 
lines. Default is 1. 

-ssep Sep is the character(s) used in separating the line number 
and the corresponding text line. Default sep is a tab. 

-wwidth Width is the number of characters to be used for the line 
number. Default width is 6. 

-nformat Format is the line numbering format. Recognized values 
are: In, left justified, leading zeroes suppressed; rn, right 
justified, leading zeroes suppressed; rz, right justified, 
leading zeroes kept. Default format is rn (right justified). 

-\num Num is the number of blank lines to be considered as one. 

For example, -12 results in only the second adjacent blank 
being numbered (if the appropriate -ha, -ba, and/or -fa 
option is set). Default is 1. 



See Also 

pr(C) 
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Name 

nohup - Runs a command immune to hangups and quits. 
Syntax 

nohup command [ arguments ] 
Description 

nohup executes command with hangups and quits ignored. If output is 
not redirected by the user, it will be sent to nohup.out. If nohup.out 
does not have write permission in the current directory, output is 
redirected to $HOME/nohup.out. 

See Also 

nice(C), signal(S) 
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Name 

od - Displays files in octal format. 



Syntax 

od [-bcdox] [ file ] [ [ + ]offset[ . ][ b ] ] 



Description 

od displays file in one or more formats as selected by the first argu- 
ment. If the first argument is missing, -o is default. The meanings of 
the format options are: 

-b Interprets bytes in octal. 

-c Interprets bytes in ASCII. Certain nongraphic characters 
appear as C escapes: null=\0, backspace=\b, form feed=\f, 
newline=\n, return=\r, tab=\t; others appear as 3-digit octal 
numbers. 

-d Interprets words in decimal. 

-o Interprets words in octal. 

-x Interprets words in hex. 

The file argument specifies which file is to be displayed. If no file 
argument is specified, the standard input is used. 

The offset argument specifies the offset in the file where displaying is 
to start. This argument is normally interpreted as octal bytes. If . is 
appended, the offset is interpreted in decimal. If b is appended, the 
offset is interpreted in blocks. If the file argument is omitted, the 
offset argument must be preceded by +. 

The display continues until end-of-file. 



See Also 

hd(C), adb(CP) 
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Name 

pack, peat, unpack - Compresses and expands files. 



Syntax 

pack [ - ] name . . . 
peat name . . . 
unpack name . . . 



Description 

pack attempts to store the specified files in a compressed form. Wher- 
ever possible, each input file name is replaced by a packed file 
name.z with the same access modes, access and modified dates, and 
the owner of name. If pack is successful, name will be removed. 
Packed files can be restored to their original form using unpack or 
peat. 

pack uses Huffman (minimum redundancy) codes on a byte-by-byte 
basis. If the - argument is used, an internal flag is set that causes pack 
to display information about the file compression. Additional 
occurrences of - in place of name will cause the internal flag to be set 
and reset. 

The amount of compression obtained depends on the size of the input 
file and the character frequency distribution. Because a decoding tree 
forms the first part of each .z file, it is usually not worthwhile to pack 
files smaller than three blocks, unless the character frequency distri- 
bution is very scattered, which may occur with printer plots or pic- 
tures. 

Typically, text files are reduced to 60-75% of their original size. Load 
modules, which use a larger character set and have a more uniform 
distribution of characters, show little compression, the packed ver- 
sions being about 90% of the original size. 

pack returns a value that is the number of files that it failed to 
compress. 

No packing will occur if: 

- The file appears to be already packed 

- The filename has more than 12 characters 
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- The file has links 

- The file is a directory 

- The file cannot be opened 

- No disk storage blocks will be saved by packing 

- A file called name.z already exists 

- The .z file cannot be created 

- An I/O error occurred during processing 

The last segment of the filename must contain no more than 12 char- 
acters to allow space for the appended .z extension. Directories can- 
not be compressed. 

Peat does for packed files what cat(C) does for ordinary files. The 
specified files are unpacked and written to the standard output. Thus 
to view a packed file named name.z use: 

peat name.z 

or just: 

peat name 

To make an unpacked copy, say nnn, of a packed file named name.z 
without destroying name.z, enter the command: 

peat name >nnn 

Peat returns the number of files it was unable to unpack. Failure may 
occur if: 

- The filename (exclusive of the .z) has more than 12 characters 

- The file cannot be opened 

- The file does not appear to be the output of pack 

unpack expands files created by pack. For each file name specified in 
the command, a search is made for a file called name.z (or just name, 
if name ends in .z). If this file appears to be a packed file, it is 
replaced by its expanded version. The new file has the .z suffix 
stripped from its name, and has the same access modes, access and 
modification dates, and owner as those of the packed file. 
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unpack returns a value that is the number of files it was unable to 
unpack. Failure may occur for the same reasons that it may in peat, as 
well as in a file where the "unpacked" name already exists, or if the 
unpacked file cannot be created. 



May 16, 1988 



Page 3 



PASSWD (C) 
Name 

passwd - Changes login password. 



PASSWD (C) 



Syntax 

passwd name 



Description 

This command changes (or installs) a password associated with the 
login name . 

The program prompts for the old password (if any) and then for the 
new one (twice). The user must supply these. Passwords can be of 
any reasonable length, but only the first eight characters of the pass- 
word are significant. The minimum number of characters allowed in a 
new password is determined by the PASSLENGTH variable. Although 
the minimum can be 3, a minimum of 5 characters is strongly recom- 
mended since passwords shorter than this are much easier to guess or 
discover by trial and error. 

Only the owner of the name or the super-user may change a password; 
the owner must prove he knows the old password. Only the super-user 
can create a null password. 

The password file is not changed if the new password is the same as 
the old password, or if the password has not "aged" sufficiently. See 
passwd(F). 

The minimum length of a legal password, and the minimum and max- 
imum number of weeks used in password aging are specified in 
/etc/default/passwd by the variables PASSLENGTH, MINWEEKS and 
MAXWEEKS. If not explicitly set, the default values for these vari- 
ables are: 

PAS SLENGTH=5 

MINWEEKS=2 

MAXWEEKS=4 

MINWEEKS and MAXWEEKS values must be in the range to 63. If 
PASSLENGTH is not in the range 3 to 8, it is set to 5. 

Notes 

When a user changes his or her password, that user's group becomes 
the group assigned to letclpasswd. This can be verified by entering the 
following command after successfully using passwd: 

1 /etc/passwd 
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Files 

/etc/default/passwd 
/etc/passwd 

See Also 

default(F), login(M), passwd(F), pwadmin(ADM) 
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Name 



pg - File perusal filter for soft-copy terminals. 



Syntax 



pg [- number ] [-p string ] [-cefns] [+ linenumber ] [+/ pattern /] 
[ files ...] 



Description 

The pg command is a filter which allows the examination of files one 
screenful at a time on a soft-copy terminal. (The dash (-) command 
line option and/or NULL arguments indicate that pg should read from 
the standard input.) Each screenful is followed by a prompt. If you 
press the RETURN key, another page is displayed; other possibilities 
are listed below. This command is different from previous paginators 
because it allows you to back up and review something that has 
already passed. 

To determine terminal attributes, pg scans the termcapQA) data base 
for the terminal type specified by the environment variable TERM. If 
TERM is not defined, the terminal type dumb is assumed. 



The command line options are: 



-number Specifies the size (in lines) of the window that pg is to 
use instead of the default. (On a terminal containing 24 
lines, the default window size is 23.) 

-p string Causes pg to use string as the prompt. If the prompt 
string contains a "%d", the first occurrence of "%d" 
in the prompt will be replaced by the current page 
number when the prompt is issued. The default prompt 
string is a colon (:). 

-c Homes the cursor and clears the screen before display- 

ing each page. This option is ignored if clear_screen 
is not defined for this terminal type in the termcap (M) 
data base. 



-e Causes pg not to pause at the end of each file. 

-f Inhibits pg from splitting lines. In the absence of the -f 

option, pg splits lines longer than the screen width, but 
some sequences of characters in the displayed text (for 
example, escape sequences for underlining) give 
undesirable results. 
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-n Normally, commands must be terminated by pressing 

the RETURN key (ASCII newline character). This 
option causes an automatic end of command as soon as 
a command letter is entered. 

-s Causes pg to display all messages and prompts in stan- 

dout mode (usually inverse video). 

+linenumber Starts up at linenumber . 

+/patternf Starts up at the first line containing the regular expres- 
sion pattern. 

The responses that may be entered when pg pauses can be divided into 
three categories: those that cause further perusal, those that search, 
and those that modify the perusal environment. 

Commands which cause further perusal normally take a preceding 
address (an optionally signed number indicating the point from which 
further text should be displayed), pg interprets this address in either 
pages or lines depending on the command. A signed address specifies 
a point relative to the current page or line, and an unsigned address 
specifies an address relative to the beginning of the file. Each com- 
mand has a default address if no address is provided. 

The perusal commands and their defaults are as follows: 

(+ 1 )RETURNkey 

Causes one page to be displayed. The address is specified in 
pages. 

(+1)1 

With a signed address, causes pg to simulate scrolling the screen, 
forward or backward, the number of lines specified. With an 
unsigned address this command displays a full screen of text 
beginning at the specified line. 

(+l)dor Ctrl-D 

Simulates scrolling half a screen forward or backward. 

The following perusal commands take no address : 

. or Ctrl-L 

Causes the current page of text to be redisplayed. 

$ Displays the last window full in the file. Use with caution when 
the input is a pipe. 

The following commands are available for searching for text patterns 
in the text. The regular expressions described in ed(C) are available. 
They must always be terminated by a newline character, even if the -n 
option is specified. 
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i I pattern I 

Search forward for the zth (default z'=l) occurrence of pattern. 
Searching begins immediately after the current page and continues 
to the end of the current file, without wrap-around. 

V pattern* 
i? pattern? 

Search backwards for the zth (default z'=l) occurrence of pattern. 
Searching begins immediately before the current page and contin- 
ues to the beginning of the current file, without wrap-around. The 
caret Q notation is useful for terminals which will not properly 
handle the question mark (?). 

After searching, pg displays the line found at the top of the screen. 
You can modify this by appending m or b to the search command to 
leave the line found in the middle or at the bottom of the window from 
now on. Use the suffix t to restore the original situation. 

The following commands modify the environment of perusal: 

in Begins perusing the zth next file in the command line. The 
default value of i is 1 . 

z'p Begins perusing the zth previous file in the command line. 
The default value of z is 1 . 

z'w Displays another window of text. If z is present, set the win- 
dow size to z. 

s filename 

Saves the input in the named file. Only the current file being 
perused is saved. The white space between the s and filename 
is optional. This command must always be terminated by a 
newline character, even if the -n option is specified. 

h Help displays abbreviated summary of available commands. 

qorQ Quit pg. 

Icommand 

command is passed to the shell, whose name is taken from the 
SHELL environment variable. If this is not available, the 
default shell is used. This command must always be ter- 
minated by a newline character, even if the -n option is 
specified. 

At any time when output is being sent to the terminal, the user can 
press the quit key (normally Ctrl-\) or the INTERRUPT (BREAK) key. 
This causes pg to stop sending output, and display the prompt. The 
user may then enter one of the above commands in the normal manner. 
Unfortunately, some output is lost when this is done, because any 
characters waiting in the terminal's output queue are flushed when the 
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quit signal occurs. 

If the standard output is not a terminal, then pg acts just like cat(C), 
except that a header is printed before each file (if there is more than 
one). 



Example 

To use pg to read system news, enter: 
news I pg -p "(Page %d):" 



Files 

/etc/termcap Terminal information data base 
/tmp/pg* Temporary file when input is from a pipe 



See Also 

ed(C), grep(C), termcap(M) 



Notes 

If terminal tabs are not set every eight positions, undesirable results 
may occur. 

When using pg as a filter with another command that changes the ter- 
minal I/O options terminal settings may not be restored correctly. 

While waiting for terminal input, pg responds to "BREAK, DEL," and 
the caret Q by terminating execution. Between prompts, however, 
these signals interrupt pg's current task and place you in prompt 
mode. Use these signals with caution when input is being read from a 
pipe, since an interrupt is likely to terminate the other commands in 
the pipeline. 
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The z and /commands used with more are available, and the terminal 
slash (/), caret Q, or question mark (?) may be omitted from the 
searching commands. 
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Name 

pr - Prints files on the standard output. 



Syntax 

pr [ options ] [ files ] 



Description 

pr prints the named files on the standard output. If file is -, or if no 
files are specified, the standard input is assumed. By default, the list- 
ing is separated into pages, each headed by the page number, date and 
time, and the name of" the file. 

By default, columns are of equal width, separated by at least one 
space; lines which do not fit are truncated. If the -s option is used, 
lines are not truncated and columns are separated by the separation 
character. 

If the standard output is associated with a terminal, error messages are 
withheld until pr has completed printing. 

Options may appear singly or combined in any order. Their meanings 
are: 

+k Begins printing with page k (default is 1). 

-k Produces ^-column output (default is 1). The options -e and -i 
are assumed for multicolumn output. 

-a Prints multicolumn output across the page. 

-m Merges and prints all files simultaneously, one per column 
(overrides the -k, and -a options). 

-d Double-spaces the output. 

-eck Expands input tabs to character positions £+1, 2*&+l, 3*&+l, 
etc. If k is or is omitted, default tab settings at every 8th posi- 
tion are assumed. Tab characters in the input are expanded into 
the appropriate number of spaces. If c (any nondigit character) 
is given, it is treated as the input tab character (default for c is 
the tab character). 

-ick In output, replaces whitespace wherever possible by inserting 
tabs to character positions £+1, 2*k+l, 3*k+l, etc. If k is or 
is omitted, default tab settings at every 8th position are 
assumed. If c (any nondigit character) is given, it is treated as 
the output tab character (default for c is the tab character). 
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-nek Provides &-digit line numbering (default for k is 5). The number 
occupies the first k+l character positions of each column of nor- 
mal output or each line of -m output. If c (any nondigit charac- 
ter) is given, it is appended to the line number to separate it 
from whatever follows (default for c is a tab). 

-wk Sets the width of a line to k character positions (default is 72 for 
equal- width multicolumn output, no limit otherwise). 

-ok Offsets each line by k character positions (default is 0). The 
number of character positions per line is the sum of the width 
and offset. 

-Ik Sets the length of a page to k lines (default is 66). 

-h Uses the next argument as the header to be printed instead of 
the filename. 

-p Pauses before beginning each page if the output is directed to a 
terminal (pr will ring the bell at the terminal and wait for a car- 
riage return). 

-f Uses form feed character for new pages (default is to use a 
sequence of linefeeds). Pauses before beginning the first page if 
the standard output is associated with a terminal. 

-r Prints no diagnostic reports on failure to open files. 

-t Prints neither the 5-line identifying header nor the 5-line trailer 
normally supplied for each page. Quits printing after the last 
line of each file without spacing to the end of the page. 

-sc Separates columns by the single character c instead of by the 
appropriate number of spaces (default for c is a tab). 

Examples 

The following prints filel and file2 as a double-spaced, three-column 
listing headed by "file list": 

pr -3dh "file list" filel file2 
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The following writes filel on file2, expanding tabs to columns 10, 19, 
28, 37, ... : 

pr -e9 -t <filel >file2 

See Also 

cat(C) 
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Name 

ps - Reports process status. 



Syntax 

ps [ options ] 



Description 

ps prints certain information about active processes. Without options, 
information is printed about processes associated with the current ter- 
minal. Otherwise, the information that is displayed is controlled by 
the following options : 



-e Prints information about all processes. 

-d Prints information about all processes, except process 

group leaders. 

-a Prints information about all processes, except process 

group leaders and processes not associated with a ter- 
minal. 



-f Generates a. full listing. (Normally, a short listing con- 

taining only process ID, terminal ("tty") identifier, 
cumulative execution time, and the command name is 
printed.) See below for meaning of columns in a full 
listing. 

-1 Generates a long listing. See below. 

-c corefile Uses the file corefile in place of /dev/mem. 

-s swapdev Uses the file swapdev in place of /dev/swap. This is 
useful when examining a corefile . 

-n namelist The argument is taken as the name of an alternate 
namelist (/xenix is the default). 

-t tlist Restricts listing to data about the processes associated 

with the terminals given in tlist, where tlist can be in 
one of two forms: a list of terminal identifiers 
separated from one another by a comma, or a list of ter- 
minal identifiers enclosed in double quotes and 
separated from one another by a comma and/or one or 
more spaces. 
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■p plist Restricts listing to data about processes whose process 
ID numbers are given in plist, where plist is in the same 
format as tlist . 



-u ulist Restricts listing to data about processes whose user ID 

numbers or login names are given in ulist , where ulist 
is in the same format as tlist . In the listing, the numeri- 
cal user ID is printed unless the -f option is used, in 
which case the login name is printed. 

-g glist Restricts listing to data about processes whose process 

groups are given in glist, where glist is a list of process 
group leaders and is in the same format as tlist . 



The column headings and the meaning of the columns in a ps listing 
are given below; the letters f and 1 indicate the option (full or long) 
that causes the corresponding heading to appear; all means that the 
heading always appears. Note that these two options only determine 
what information is provided for a process; they do not determine 
which processes will be listed. 



(1) A status word consisting of flags associated with 

the process. Each flag is associated with a bit in 
the status word. These flags are added to form a 
single octal number. Process flag bits and their 
meanings are: 

01 in core; 

02 system process; 

04 locked in core (e.g., for physical I/O); 
10 being swapped; 
20 being traced by another process. 

(1) The state of the process: 

non-existent; 

5 sleeping; 
W waiting; 
R running; 

1 intermediate; 
Z terminated; 
T stopped; 
B waiting. 

(f,l) The user ID number of the process owner; the 
login name is printed under the -f option. Login 
names are truncated after 7 characters, 
(all) The process ID of the process; it is possible to kill 
a process if you know this datum. 
PPID (f,l) The process ID of the parent process. 
C (f,l) Processor utilization for scheduling. 
STIME (f) Starting time of the process. 

PRI (1) The priority of the process; higher numbers mean 

lower priority. 



UID 



PID 
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NI (1) Nice value; used in priority computation. 

ADDR (1) The memory address of the process, if resident; 

otherwise, the disk address. 

SZ (1) The size in blocks of the core image of the pro- 

cess, but not including the size of text shared with 
other processes. Since this size includes the 
current size of the stack, it will vary as the stack 
size varies. 

WCHAN(l) The event for which the process is waiting or 

sleeping; if blank, the process is running. 

TTY (all) The controlling terminal for the process. 

TIME (all) The cumulative execution time for the process. 

CMD (all) The command name; the full command name and 
its arguments are printed under the -f option. 



A process that has exited and has a parent, but has not yet been waited 
for by the parent, is marked <defunct>. 

Under the -f option, ps tries to determine the command name and 
arguments given when the process was created by examining memory 
or the swap area. Failing this, the command name, as it would appear 
without the -f option, is printed in square brackets. 



Files 

/xenix system namelist 

/dev/mem memory 

/dev searched to find swap device and terminal ("tty") names. 



See Also 

kill(C), nice(C) 



Notes 

Things can change while ps is running; the picture it gives is only a 
close approximation to reality. 

Some data printed for defunct processes are irrelevant. 
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Name 

pstat - Reports system information. 



Syntax 

pstat [ -aixpf ] [ -u ubase ] [ -c corefile ] 
[ -n namelist ] [ file ] 



Description 

pstat interprets the contents of certain system tables, pstat searches 
for these tables in /dev/mem and /dev/kmem. With the file given, the 
tables are sought in the specified file rather than /dev/mem. Similarly, 
the -c option allows one to specify a corefile rather than /dev/kmem 
for the search. The required namelist is taken from /xenix. Options 
are: 

-a Under -p, describe all process slots rather than just active 

ones. 

-i Print the inode table with these headings: 

LOC The core location of this table entry. 
FLAGS Miscellaneous state variables encoded thus: 
L Locked 

U Update time filesystem (F) must be corrected 

A Access time must be corrected 

M File system is mounted here 

W Wanted by another process (L flag is on) 

T Contains a text file 

C Changed time must be corrected 

CNT Number of open file table entries for this inode. 

DEV Major and minor device number of file system in 
which this inode resides. 

INO I-number within the device. 

MODE Mode bits, see chmod(S). 

NLK Number of links to this inode. 

UID User ID of owner. 

SIZ/DEV 

Number of bytes in an ordinary file, or major and 
minor device of special file. 

-x Prints the text table with these headings (286 only): 

LOC The core location of this table entry. 
FLAGS Miscellaneous state variables encoded thus: 
T ptrace (S) in effect 
W Text not yet written on swap device 
L Loading in progress 
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K Locked 

w Wanted (L flag is on) 
DADDR Disk address in swap, measured in multiples of 
BSIZE bytes. 

CADDR Core address, measured in units of memory 
management resolution. 

SIZE Size of text segment, measured in units of memory 
management resolution. 

IPTR Core location of corresponding inode. 

CNT Number of processes using this text segment. 

CCNT Number of processes in core using this text seg- 
ment. 

-p Prints process table for active processes with these head- 

ings: 

LOC The core location of this table entry. 
S Run state encoded thus: 

No process 

1 Waiting for some event 

3 Runnable 

4 Being created 

5 Being terminated 

6 Stopped under trace 

F Miscellaneous state variables, ORed together: 

01 Loaded 

02 The scheduler process 
04 Locked 

010 

Swapped out 
020 

Traced 
040 

Used in tracing 
0100 

Locked in by lock(S). 
PRI Scheduling priority, see nice(S). 
SIGNAL Signals received (signals 1-16 coded in bits 0-15). 
UID Real user ID. 

TIM Time resident in seconds; times over 127 coded as 
127. 

CPU Weighted integral of CPU time, for scheduler. 
NI Nice level, see nice(S). 

PGRP Process number of root of process group (the 
opener of the controlling terminal). 

PID The process ID number. 

PPID The process ID of parent process. 

ADDR If in core, the physical address of the ' 'u-area' ' of i 
the process measured in units of memory manage- 
ment resolution. If swapped out, the position in 
the swap area is measured in multiples of BSIZE 
bytes. 
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WCHAN 

Wait channel number of a waiting process. 
LINK Link pointer in list of runnable processes. 
TEXTP If text is pure, pointer to location of text table 

entry (286 only). 
INODP Pointer to location of shared inode (386 only). 
CLKT Countdown for alarm(S) measured in seconds. 

-u ubase 

Print information about a user process. Ubase is the hexade- 
cimal location of the process in main memory. The address 
may be obtained by using the long listing ( -1 option) of the 
ps(C) command. 

-c corefile 

Use the file corefile in place of /dev/kmem. 
-n namelist 

Use the file namelist as an alternate namelist in place of 
/xenix. 

-f Print the open file table with these headings: 

LOC The core location of this table entry. 
FLG Miscellaneous state variables: 

R Open for reading 

W Open for writing 

P Pipe 

CNT Number of processes that know this open file. 
INO The location of the inode table entry for this file. 
OFFS The file offset, see lseek(S). 



Files 

/xenix Namelist 

/dev/mem Default source of tables 



See Also 

ps(C), stat(S), filesystem(F) 
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Name 

pwcheck - Checks password file. 

Syntax 

pwcheck [file] 

Description 

pwcheck scans the password file and checks for any inconsistencies. 
The checks include validation of the number of fields, login name, 
user ID, group ID, and whether the login directory and optional pro- 
gram name exist. The default password file is /etc/passwd. 

Files 

/etc/passwd 

See Also 

grpcheck(C), group(F), passwd(F) 
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Name 

pwd - Prints working directory name. 

Syntax 
pwd 

Description 

pwd prints the pathname of the working (current) directory. 

See Also 

cd(C) 

Diagnostics 

"Cannot open .." and "Read error in .." indicate possible file system 
trouble. In such cases, see the XENIX System Administrator's Guide 
for information on fixing the file system. 
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Name 

quot - Summarizes file system ownership. 



Syntax 

quot [ option ] ... [ filesystem ] 



Description 

quot prints the number of blocks in the named filesystem currently 
owned by each user. If no filesystem is named, the file systems given 
in /etc/mnttab are examined. 

The following options are available: 

-n Processes standard input. This option makes it possible to produce 
a list of all files and their owners with the following command: 

ncheck filesystem I sort +0n I quot -n filesystem 

-c Prints three columns giving file size in blocks, number of files of 
that size, and cumulative total of blocks in that size or smaller file. 
Data for files of size greater than 499 blocks are included in the 
figures for files of exactly size 499. 

-f Prints a count of the number of files as well as space owned by 
each user. 



Files 



/etc/passwd 



Gets user names 



/etc/mnttab 



Contains list of mounted file systems 



See Also 



cmchk(C), du(C), ls(C), machine(M) 
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Notes 

Holes in files are counted as if they actually occupied space. 

Blocks are reported in 512 byte blocks. On filesystems that use 1024 
byte blocks, a file of 26 bytes is reported as using 2 blocks, since it 
uses one 1024 byte block, or two 512 byte blocks. See machine (M) or 
use cmchk(C) to determine the filesystem block size. 

See also Notes under mount (ADM). 
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Name 

random - Generates a random number. 

Syntax 

random [-s] [ scale ] 

Description 

random generates a random number on the standard output, and 
returns the number as its exit value. By default, this number is either 
or 1 (i.e., scale is 1 by default). If scale is given a value between 1 
and 255, then the range of the random value is from to scale. If scale 
is greater than 255, an error message is printed. 

When the -s , "silent' ' option is given, the random number is returned 
as an exit value but is not printed on the standard output. If an error 
occurs, random returns an exit value of zero. 

See Also 

rand(S) 

Notes 

This command does not perform any floating point computations. 
random uses the time of day as a seed. 
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Name 

rep - Copies files across XENIX systems. 



Syntax 

rep [ options ] [srcmachine:]srcfile [destmachine:]destfile 



Description 

rep copies files between systems in a Micnet network. The command 
copies the sremachine: srefile to destmachine:destfile , where 
sremachine : and destmachine : are optional names of systems in the 
network, and srefile and destfile are pathnames of files. If a machine 
name is not given, the name of the current system is assumed. If - is 
given in place of srefile, rep uses the standard input as the source. 
Directories named on the destination machine must have write per- 
mission, and directories and files named on a remote source machine 
must have read permission. 

The available options are: 

-m 

Mails and reports completion of the command, whether there is an 
error or not. 

-u [machine:]user 

Any mail goes to the named user on machine. The default 
machine is the machine on which the rep command is completed 
or on which an error was detected. If an alias for user exists in the 
system alias files on that machine, the mail will be redirected to 
the appropriate mailbox(es). Since system alias files are usually 
identical throughout the network, any specified machine will most 
likely be overridden by the aliasing mechanism. To prevent alias- 
ing, user must be escaped with at least two \ characters (at least 
four if given as a shell command). 
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rep is useful for transferring small numbers of files across the network. 
The network consists of daemons that periodically awaken and send 
files from one system to another. The network must be installed using 
netutil (ADM) before rep can be used. 

Also, to enable transfer of files from a remote system, either: 

This line should be in /etc/ default/ micnet on the systems in the net- 
work: 

rcp=/usr/bin/rcp 
Or, these lines should be in that file: 
executeall 

execpath=P ATH= path 
where path must contain lusrlbin. 

Example 

rep -m machine l:/etc/mnttab /tmp/vtape 
See Also 

mail(C), micnet(F), netutil(ADM), remote(C) 

Diagnostics 

If an error occurs, mail is sent to the user. 

Notes 

Full pathnames must be specified for remote files. 

rep handles binary data files transparently, no extra options or proto- 
cols are needed to handle them. Wildcards are not expanded on the 
remote machine. 
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Name 

red - Invokes a restricted version of ed(C). 

Syntax 
red [ file ] 

Description 

red is a restricted version of ed(C). It will only allow editing of files 
in the current directory. It prohibits executing sh(C) commands via 
the ! command, red displays an error message on any attempt to 
bypass these restrictions. 

In general, red does not allow commands like 

!date 

or 

!sh 

Furthermore, red will not allow pathnames in its command line. For 
example, the command: 

red /etc/passwd 

when the current directory is not /etc causes an error. 

See Also 

ed(C), rsh(C) 



May 16, 1988 



Page 1 



REMOTE (C) 



REMOTE (C) 



Name 

remote - Executes commands on a remote XENIX system. 



Syntax 

remote [ - ] [ -f file ] [ -m ] [ -u user] machine 
command [ arguments ] 



Description 

remote is a limited networking facility that permits execution of 
XENIX commands across serial lines. Commands on any connected 
system may be executed from the host system using remote. A com- 
mand line consisting of command and any blank-separated arguments 
is executed on the remote machine . A machine's name is located in 
the file /etc/systemid. Note that wild cards are not expanded on the 
remote machine, so they should not be specified in arguments. The 
optional -m switch causes mail to be sent to the user telling whether 
the command is successful. 

The available options follow: 

A dash signifies that standard input is used as the standard 
input for command on the remote machine. Standard 
input comes from the local host and not from the remote 
machine. 

-ifile Use the specified file as the standard input for command 
on the remote machine . The file exists on the local host 
and not on the remote machine. 

-m Mails the user to report completion of the command. By 

default, mail reports only errors. 

-u user Any mail goes to the named user on machine. The default 
machine is the machine on which an error was detected, 
or on which the remote command was completed. The 
mail will be redirected to the appropriate mailbox(es), if 
an alias for user exists in the system alias files on that 
machine . Since system alias files are usually identical 
throughout the network, any specified machine will most 
likely be overridden by the aliasing mechanism. To 
prevent aliasing, user must be escaped with at least two \ 
characters (at least four if given as a shell command). 
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Before remote can be successfully used, a network of systems must 
first be set up and the proper daemons initialized using netutil (ADM). 
Also, entries for the command to be executed using remote must be 
added to the /etc/ default! micnet files on each remote machine. 



Example 

The following command executes an Is command on the directory 
/tmp of the machine machinel : 

remote machinel Is /tmp 

See Also 

rcp(C), mail(C), netutil(ADM), micnet(F) 



Notes 

The mail command uses the equivalent of remote to send mail 
between machines. 
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Name 

restore, restor - Invokes incremental file system restorer. 



Syntax 

restore key [ arguments ] 
restor key [ arguments ] 



Description 

restore is used to read archive media backed up with the backup(C) 
command. 

The key specifies what is to be done. Key is one of the characters cC, 
rR, tT, or xX optionally combined with k and/or f or F. restor is an 
alternate spelling for the same command. 

c,C 

Verify (check) a dump tape. Used after a dump is made to make 
sure the tape has no I/O errors or bad checksums. C is the same as 
c except that it provides a higher level of checking. 

f Uses the first argument as the name of the archive (backup device 
/dev/*) instead of the default. 

F F is the number of the first file on the tape to read. All files up to 
that point are skipped. 

k Follow this option with the size of the backup volume. This allows 
for reading multivolume dumps from media such as floppies. 

r,R 

The archive is read and loaded into the file system specified in 
argument. This should not be done lightly (see below). If the key 
is R, restore asks which archive of a multivolume set to start on. 
This allows restore to be interrupted and then restarted (an fsck 
must be done before the restart). 

t Prints the date the archive was written and the date the file system 
was backed up. 

T Prints a full listing of a dump tape. Similar to t. 

x Each file on the archive named by an argument is extracted. The 
filename has all "mount" prefixes removed; for example, if /usr is 
a mounted file system, /usr/bin/lpr is named /bin/lpr on the 
archive. 

The extracted file is placed in a file with a numeric name supplied 
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by restore (actually the inode number). In order to keep the 
amount of archive read to a minimum, the following procedure is 
recommended: 

1. Mount volume 1 of the set of backup archives. 

2. Type the restore command with the appropriate key and argu- 
ments. 

3. restore will check dumpdir, then announce whether or not it 
found the files, give the numeric name that it will assign to the 
file, and in the case of a tape, rewind to the start of the archive. 

4. It then asks you to ' 'mount the desired tape volume' '. Type the 
number of the volume you choose. On a multivolume backup, 
the recommended procedure is to mount the last through the 
first volumes, in that order, restore checks to see if any of the 
requested files are on the mounted archive (or a later archive, 
thus the reverse order). If the requested files are not there, 
restore doesn't read through the tape. If you are working with a 
single- volume backup or if the number of files being restored is 
large, respond to the query with 1 and restore will read the 
archives in sequential order. 

X Same as x except that files are replaced in original location. When 
you use this option, omit the initial slash ( / ) in the filename on the 
restore command line. 

The r option should only be used to restore a complete backup archive 
onto a clear file system, or to restore an incremental backup archive 
onto a file system so created. It should not be used to restore a backup 
archive onto the root file system. Thus: 

/etc/mkfs /dev/hdl 10000 
restore r /dev/hdl 

is a typical sequence to restore a complete backup. Another restore 
can be done to get an incremental backup in on top of this. 

A backup followed by a mkfs and a restore is used to change the size 
of a file system. 
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Files 



rst* 



Temporary files 



/etc/default/restor 



Name of default archive device 



The default archive unit varies with installation. 



Notes 



It is not possible to successfully restore an entire active root file sys- 
tem. 

Note also that restore may be unable to restore more than one filesys- 
tem from the tape devices IdevlnrctO and Idevlnrctl. 



There are various diagnostics involved with reading the archive and 
writing the disk. There are also diagnostics if the i-list or the free list 
of the file system is not large enough to hold the dump. 

If the dump extends over more than one disk or tape, restor may ask 
you to change disks or tapes. Reply with a newline when the next unit 
has been mounted. 



backup(C), dumpdir(C), fsck(ADM), mkfs(ADM), sddate(C) 



Diagnostics 



See Also 
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Name 

rm, rmdir - Removes files or directories. 



Syntax 

rm [ -fri ] file ... 

rmdir dir ... 
Description 

rm removes the entries for one or more files from a directory. If an 
entry was the last link to the file, the file is destroyed. Removal of a 
file requires write permission in its directory, but neither read nor 
write permission on the file itself. 

If a file has no write permission and the standard input is a terminal, 
its permissions are printed and a line is read from the standard input. 
If that line begins with y, the file is deleted, otherwise the file 
remains. No questions are asked when the -f option is given or if the 
standard input is not a terminal. 

If a designated file is a directory, an error comment is printed unless 
the optional argument -r has been used. In that case, rm recursively 
deletes the entire contents of the specified directory, and the directory 
itself. 

If the -i (interactive) option is in effect, rm asks whether to delete 
each file, and if the -r option is in effect, whether to examine each 
directory. 

The special option can be used to delimit options. For example, 
a file named "-f" could not be removed by rm because the hyphen is 
interpreted as an option; the command rm -f would do nothing, since 
no file is specified. Using rm - -f removes the file successfully. 

rmdir removes empty directories. 



See Also 

rmdir(C) 



Diagnostics 

Generally self-explanatory. It is forbidden to remove the file .. to 
avoid the consequences of inadvertently doing something like: 
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rm -r .* 

It is also forbidden to remove the root directory of a given file system. 

No more than 17 levels of subdirectories can be removed using the -r 
option. 
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Name 

rmdir - Removes directories. 



Syntax 

rmdir dir ... 
Description 

rmdir removes the entries for one or more subdirectories from a direc- 
tory. A directory must be empty before it can be removed, rmdir 
enforces a standard and safe procedure for removing a directory; the 
contents of the directory must be removed before the directory itself 
can be deleted with rmdir . Note that the "rm -r dir" command is a 
more dangerous alternative to rmdir. 



See Also 

rm(C) 



Notes 

rmdir will refuse to remove the root directory of a mounted file sys- 
tem. 
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RSH (C) 



Name 

rsh - Invokes a restricted shell (command interpreter). 



Syntax 

rsh [ flags ] [ name [ argl ... ] ] 



Description 

rsh is a restricted version of the standard command interpreter sh (C). 
It is used to set up login names and execution environments whose 
capabilities are more controlled than those of the standard shell. The 
actions of rsh are identical to those of sh, except that changing direc- 
tory with cd, setting the value of $PATH, using command names con- 
taining slashes, and redirecting output using > and » are all disal- 
lowed. 

When invoked with the name -rsh, rsh reads the user's .profile (from 
$HOME/.profile). It acts as the standard sh while doing this, except 
that an interrupt causes an immediate exit, instead of causing a return 
to command level. The restrictions above are enforced after .profile 
is interpreted. 

When a command to be executed is found to be a shell procedure, rsh 
invokes sh to execute it. Thus, it is possible to provide to the end user 
shell procedures that have access to the full power of the standard 
shell, while restricting him to a limited menu of commands; this 
scheme assumes that the end user does not have write and execute per- 
missions in the same directory. 

The net effect of these rules is that the writer of the .profile has com- 
plete control over user actions, by performing guaranteed setup 
actions, then leaving the user in an appropriate directory (probably not 
the login directory). 

rsh is actually just a link to sh and any flags arguments are the same 
as for sh{C). 

The system administrator often sets up a directory of commands that 
can be safely invoked by rsh. 



See Also 

sh(C), profile(M) 
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Name 

sddate - Prints and sets backup dates. 



Syntax 

sddate [ name lev date ] 



Description 

If no argument is given, the contents of the backup date file /etc/ddate 
are printed. The backup date file is maintained by backup (C) and 
contains the date of the most recent backup for each backup level for 
each filesystem. 

If arguments are given, an entry is replaced or made in /etc/ddate. 
name is the last component of the device pathname, lev is the backup 
level number (from to 9), and date is a time in the form taken by 
dateiC): 

mmddhhmm [y y ] 

Where the first mm is a two-digit month in the range 01-12, dd is a 
two-digit day of the month, hh is a two-digit military hour from 00-23, 
and the final mm is a two-digit minute from 00-59. An optional two- 
digit year, yy, is presumed to be an offset from the year 1900, i.e., 
\9yy. 

Some sites may wish to back up file systems by copying them verba- 
tim to backup media, sddate could be used to make a "level 0" entry 
in /etc/ddate, which would then allow incremental backups. 

For example: 

sddate rhdO 5 10081520 

makes an /etc/ddate entry showing a level 5 backup of /dev/rhdO on 
October 8, at 3:20 PM. 



Files 

/etc/ddate 
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See Also 

backup(C), dump(C), date(C) 

Diagnostics 

bad conversion If the date set is syntactically incorrect. 
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Name 

sdiff - Compares files side-by-side. 



SDIFF (C) 



Syntax 

sdiff [ options ... ] filel file2 



Description 

sdiff uses the output of diff(C) to produce a side-by-side listing of two 
files indicating those lines that are different. Each line of the two files 
is printed with a blank gutter between them if the lines are identical, a 
< in the gutter if the line only exists in filel , a > in the gutter if the 
line only exists in filel , and a | for lines that are different. 

For example: 

x I y 

a a 
b < 
c < 
d d 
> c 

The following options exist: 

-w n Uses the next argument, n, as the width of the output 

line. The default line length is 130 characters. 

-1 Only prints the left side of any lines that are identical. 

-s Does not print identical lines. 

-o output Uses the next argument, output, as the name of a third 
file that is created as a user-controlled merging of filel 
and file2 . Identical lines of filel and filel are copied to 
output. Sets of differences, as produced by diff(C), are 
printed; where a set of differences share a common 
gutter character. After printing each set of differences, 
sdiff prompts the user with a % and waits for one of the 
following user- typed commands: 

1 Appends the left column to the output file 

r Appends the right column to the output file 

s Turns on silent mode; does not print identi- 
cal lines 
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v Turns off silent mode 
e I 

Calls the editor with the left column 

e r 

Calls the editor with the right column 



Calls the editor with the concatenation of 
left and right 

e Calls the editor with a zero length file 

q Exits from the program 



On exit from the editor, the resulting file is concatenated 
on the end of the output file. 



e 



b 



See Also 



diff(C), ed(C) 
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Name 

sed - Invokes the stream editor. 



Syntax 

sed [ -n ] [ -e script ] [ -f sfile ] [ files ] 



Description 

sed copies the named files (standard input default) to the standard out- 
put, edited according to a script of commands. The -f option causes 
the script to be taken from file sfile; these options accumulate. If 
there is just one -e option and no -f options, the flag -e may be omit- 
ted. The -n option suppresses the default output. A script consists of 
editing commands, one per line, of the following form: 

[ address [ , address ] ] function [ arguments ] 

In normal operation, sed cyclically copies a line of input into a pattern 
space (unless there is something left after a D command), applies in 
sequence all commands whose addresses select that pattern space, 
and at the end of the script copies the pattern space to the standard 
output (except under -n) and deletes the pattern space. 

A semicolon (;) can be used as a command delimiter. 

Some of the commands use a hold space to save all or part of the pat- 
tern space for subsequent retrieval. 

An address is either a decimal number that counts input lines cumula- 
tively across files, a $ that addresses the last line of input, or a context 
address, i.e., a /regular expression/ in the style of ed(C) modified as 
follows: 

- In a context address, the construction \? regular expression? , where 
? is any character, is identical to /regular expression/. Note that 
in the context address \xabc\xdefx, the second x stands for itself, 
so that the regular expression is abcxdef. 

- The escape sequence \n matches a newline embedded in the pat- 
tern space. 

- A period . matches any character except the terminal newline of 
the pattern space. 

- A command line with no addresses selects every pattern space. 
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- A command line with one address selects each pattern space that 
matches the address. 

- A command line with two addresses selects the inclusive range 
from the first pattern space that matches the first address through 
the next pattern space that matches the second. (If the second 
address is a number less than or equal to the line number first 
selected, only one line is selected.) Thereafter, the process is 
repeated, looking again for the first address. 

Editing commands can be applied only to nonselected pattern spaces 
by use of the negation function ! (below). 

In the following list of functions, the maximum number of permissible 
addresses for each function is indicated in parentheses. 

The text argument consists of one or more lines, all but the last of 
which end with backslashes to hide the newlines. Backslashes in text 
are treated like backslashes in the replacement string of an s com- 
mand, and may be used to protect initial blanks and tabs against the 
stripping that is done on every script line. The rfile or wfile argument 
must terminate the command line and must be preceded by exactly 
one blank. Each wfile is created before processing begins. There can 
be at most 10 distinct wfile arguments. 

U)a\ 

text Appends text , placing it on the output before reading the 

next input line. 

(2) b label Branches to the : command bearing the label . If label is 
empty, branches to the end of the script. 

(2)c\ 

text Changes text by deleting the pattern space and then 

appending text. With or 1 address or at the end of a 2- 
address range, places text on the output and starts the next 
cycle. 

(2) d Deletes the pattern space and starts the next cycle. 

(2)D Deletes the initial segment of the pattern space through 
the first newline and starts the next cycle. 

(2) g Replaces the contents of the pattern space with the con- 

tents of the hold space. 

(2)G Appends the contents of the hold space to the pattern ( 
space. 

(2) h Replaces the contents of the hold space with the contents 

of the pattern space. 
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(2)H Appends the contents of the pattern space to the hold 
space. 

d)i\ 

text Insert. Places text on the standard output. 

(2)1 Lists the pattern space on the standard output with non- 

printing characters spelled in two-digit ASCII and long 
lines folded. 

(2) n Copies the pattern space to the standard output. Replaces 

the pattern space with the next line of input. 

(2) N Appends the next line of input to the pattern space with an 
embedded newline. (The current line number changes.) 

(2) p Prints (copies) the pattern space on the standard output. 

(2)P Prints (copies) the initial segment of the pattern space 

through the first newline to the standard output. 

(1) q Quits sed by branching to the end of the script. No new 

cycle is started. 

(2) r rfile Reads the contents of rfile and places them on the output 

before reading the next input line. 

(2)s/regular expression/ replacement/flags 

Substitutes the replacement string for instances of the 
regular expression in the pattern space. Any character 
may be used instead of /. For a more detailed description, 
see ed(C). Flags is zero or more of: 

n n=l-512. Substitute for just the nth occurrence of the 
regular expression. 

g Globally substitutes for all nonoverlapping instances 
of the regular expression rather than just the first one. 

p Prints the pattern space if a replacement was made. 

w wfile 

Writes the pattern space to wfile if a replacement was 
made. 

(2) t label Branches to the colon (:) command bearing label if any 
substitutions have been made since the most recent read- 
ing of an input line or execution of a t command. If label 
is empty, t branches to the end of the script. 
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(2) w wfile Writes the pattern space to wfile . 

(2) x Exchanges the contents of the pattern and hold spaces. 

(2) y /stringl I string! / 

Replaces all occurrences of characters in stringl with the 
corresponding characters in stringl. The lengths of 
stringl and string2 must be equal. 

(2)! function 

Applies the function (or group, if function is { ) only to 
lines not selected by the address(es). 

(0) : label This command does nothing; it bears a label for b and t 

commands to branch to. 

(1) = Places the current line number on the standard output as a 

line. 

(2) { Executes the following commands through a matching } 

only when the pattern space is selected. 

(0) An empty command is ignored. 



See Also 

awk(C), ed(C), grep(C) 



Notes 

This command is explained in detail in XENIX Text Processing Guide. 
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Name 

setcolor, setcolour - Set screen color. 



Syntax 

setcolor -[nbrgopc] argument [argument] 



Description 

setcolor allows the user to set the screen color on a color screen. Both 
foreground and background colors can be set independently in a range 
of 16 colors, setcolor can also set the reverse video and graphics 
character colors, setcolor with no arguments produces a usage mes- 
sage that displays all available colors, then resets the screen to its pre- 
vious state. 



For example, the following strings are possible colors. 

blue magenta brown black 

lt_blue lt_magenta yellow gray 

cyan white green red 

It _ cyan hi_white lt_green lt_red 

The following flags are available. In the arguments below, "color" is 
taken from the above list. 



-n Set the screen to "normal" white characters on black background. 
color [color] 

Set the foreground to the first color. Sets background to second 
color if a second color choice is specified. 

-b color 

Set the background to the specified color, 
-r color 

Set the foreground reverse video characters to the first color. Set 
reverse video characters ' background to second color. 

-g color 

Set the foreground graphics characters to the first color. Set graph- 
ics characters ' background to second color. 

-o Set the color of the screen border (overscan region). 

-p pitch duration 

Set the pitch and duration of the bell. Pitch is the period in 
microseconds, and duration is measured in fifths of a second. 
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When using this option, a control-G (bell) must be echoed to the 
screen for the command to work. For example: 

setcolor -p 2500 2 
echo "G 

-cfirst last 

Set the first and last scan lines of the cursor. (For more informa- 
tion see screen(HW).) 

Notes 

The ability of setcolor to set any of these described functions is ulti- 
mately dependent on the ability of devices to support them, setcolor 
emits an escape sequence that may or may not have an effect on mono- 
chrome devices. 

Occasionally changing the screen color can help prolong the life of 
your monitor. 



See Also 

screen(HW), console(HW) 
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Name 

setkey - Assigns the function keys. 



SETKEY (C) 



Syntax 

setkey keynum string 



Description 

The setkey command assigns the given ANSI string to be the output 
of the computer function key given by keynum. For example, the 
command: 

setkey 1 date 

assigns the string "date" as the output of function key 1. The string 
can contain control characters, such as a newline character, and 
should be quoted to protect it from processing by the shell. For exam- 
ple, the command: 

setkey 2 "pwd ; lc\n" 

assigns the command sequence "pwd ; lc" to function key 2. Notice 
how the newline character is embedded in the quoted string. This 
causes the commands to be carried out when function key 2 is pressed. 
Otherwise, the Enter key would have to be pressed after pressing the 
function key, as in the previous example. 



Files 

/bin/setkey 



See Also 

keyboard(HW) 



Notes 

setkey works only on the console keyboard. 

The string mapping table is where the function keys are defined. It is 
an array of 512 bytes (typedef strmapj ) where null terminated strings 
can be put to redefine the function keys. The first null terminated 
string is assigned to the first string key, the second to the second string 
key, and so on. There is one string mapping table per multiscreen. 
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Although the size of the setkey string mapping table is 512 bytes, 
there is a limit of 30 characters that can be assigned to any individual 
function key. 

Assigning more than 512 characters to the string mapping table causes 
the function key buffer to overflow. When this happens, the sequences 
sent by the arrow keys are overwritten, effectively disabling them. 
Once the function key buffer overflows, the only way to enable the 
arrow keys is to reboot the system. 



The table below lists the key num. values for the function keys: 



Function key 


keynum 


Function key 


keynum 


Fl 


1 


Ctrl-Fl 


34 


rz 


Z 


Ctrl-rl 1 


3~> 




5 


Ctrl-rl 2 


3o 


T7A 


A 

4 


Ctrl-bnilt-rl 


3 / 


rj 


5 


Ctrl-bnirt-rz 


3o 


ro 


ST 

6 


/"-•V /I or, If*. "CO 

Ctrl-Snilt-F3 


O A 

39 


t / 


7 


Ctrl-Shirt-M 


/l A 

40 


ro 


o 
O 


Ctrl-bnirt-r5 


A 1 

41 


by 


9 


Ctrl-bniit-ro 


A O 

42 




1 A 
10 


Ctrl-t>nirt-r 7 


43 


ri 1 


1 1 
1 1 


Ctrl-bnirt-Fo 


A A 

44 


rlz 


1 o 

iz 


Ctrl-i>nitt-ry 


4j 


onirt-r 1 


1 j 


Ctrl-bnirt-rlU 


4o 


onilt-rz 


14 


Ctri-oniit-r 1 1 


4/ 


onitt-rj 


1 ^ 
1 J 


Ctrl-bniit-rlz 


4o 


CUift "CM 

onirt-r4 


ID 










onitt-rO 


1 n 
1 / 


Numeric Key-Pad 


keynum 


Shift-F6 


18 










Shift-F7 


19 


7 


49 


Shift-F8 


20 


8 


50 


Shift-F9 


21 


9 


51 


Shift-FlO 


22 




52 


Shift-Fll 


23 


4 


53 


Shift-F12 


24 


5 


54 


Ctrl-Fl 


25 


6 


55 


Ctrl-F2 


26 


+ 


56 


Ctrl-F3 


27 


1 


57 


Ctrl-F4 


28 


2 


58 


Ctrl-F5 


29 


3 


59 


Ctrl-F6 


30 





60 


Ctrl-F7 


31 






Ctrl-F8 


32 






Ctrl-F9 


33 
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Name 

sh - Invokes the shell command interpreter. 



Syntax 

sh [ -ceiknrstuvx ] [ args ] 



Description 

The shell is the standard command programming language that exe- 
cutes commands read from a terminal or a file. See Invocation below 
for the meaning of arguments to the shell. 



Commands 

A simple -command is a sequence of nonblank words separated by 
blanks (a blank is a tab or a space). The first word specifies the name 
of the command to be executed. Except as specified below, the 
remaining words are passed as arguments to the invoked command. 
The command name is passed as argument (see exec(S)). The value 
of a simple-command is its exit status if it terminates normally, or 
(octal) 1000+status if it terminates abnormally (i.e., if the failure pro- 
duces a core file). See signal(S) for a list of status values. 

A pipeline is a sequence of one or more commands separated by a 
vertical bar ( I ). (The caret ( A ), is an obsolete synonym for the verti- 
cal bar and should not be used in a pipeline.) The standard output of 
each command but the last is connected by a pipe (S) to the standard 
input of the next command. Each command is run as a separate pro- 
cess; the shell waits for the last command to terminate. 

A list is a sequence of one or more pipelines separated by ;, &, &&, 
or 1 1 , and optionally terminated by ; or & . Of these four symbols, ; 
and & have equal precedence, which is lower than that of && and 1 1 . 
The symbols && and 1 1 also have equal precedence. A semicolon (;) 
causes sequential execution of the preceding pipeline; an ampersand 
(&) causes asynchronous execution of the preceding pipeline (i.e., the 
shell does not wait for that pipeline to finish). The symbol && ( 1 1 ) 
causes the list following it to be executed only if the preceding pipe- 
line returns a zero (nonzero) exit status. An arbitrary number of new- 
lines may appear in a list, instead of semicolons, to delimit com- 
mands. 
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A command is either a simple-command or one of the following com- 
mands. Unless otherwise stated, the value returned by a command is 
that of the last simple-command executed in the command: 

for name [ in word ... ] 
do 

list 
done 

Each time a for command is executed, name is set to the next word 
taken from the in word list. If in word is omitted, then the for com- 
mand executes the do list once for each positional parameter that is 
set (see Parameter Substitution below). Execution ends when there 
are no more words in the list. 

case word in 

[ pattern [ I pattern ] . . . ) list 

;; ] 

esac 

A case command executes the list associated with the first pat- 
tern that matches word. The form of the patterns is the same as that 
used for filename generation (see Filename Generation below). 

if list then 
list 

[ elif list then 

list ] 
[ else list ] 
fi 

The list following if is executed and, if it returns a zero exit status, the 
list following the first then is executed. Otherwise, the list following 
elif is executed and, if its value is zero, the list following the next 
then is executed. Failing that, the else list is executed. If no else list 
or then list is executed, then the if command returns a zero exit status. 

while list 
do 

list 
done 

A while command repeatedly executes the while list and, if the exit 
status of the last command in the list is zero, executes the do list; oth- 
erwise the loop terminates. If no commands in the do list are exe- 
cuted, then the while command returns a zero exit status; until may be 
used in place of while to negate the loop termination test. 

(list) 

Executes list in a subshell. 

{list ;} 

list is simply executed. 
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name () {list;} 

Define a function which is referenced by name. The body of func- 
tions is the list of commands between { and }. Execution of func- 
tions is described later (see Execution.) 



The following words are recognized only as the first word of a com- 
mand and when not quoted: 

if then else elif fi case esac for while until do done { } 



Comments 

A word beginning with # causes that word and all the following char- 
acters up to a newline to be ignored. 



Command Substitution 

The standard output from a command enclosed in a pair of grave 
accents ( s v ) may be used as part or all of a word; trailing newlines 
are removed. 



Parameter Substitution 

The character $ is used to introduce substitutable parameters . Posi- 
tional parameters may be assigned values by set. Variables may be set 
by writing: 

name-value [ name-value ] ... 

Pattern-matching is not performed on value . 

^{parameter} 

A parameter is a sequence of letters, digits, or underscores (a 
name), a digit, or any of the characters *, @, #, ?, -, $, and !. The 
value, if any, of the parameter is substituted. The braces are 
required only when parameter is followed by a letter, digit, or 
underscore that is not to be interpreted as part of its name. A name 
must begin with a letter or underscore. If parameter is a digit then 
it is a positional parameter. If parameter is * or @, then all the 
positional parameters, starting with $1, are substituted (separated 
by spaces). Parameter $0 is set from argument zero when the shell 
is invoked. 

%{parameter :-word} 

If parameter is set and is not a null argument, substitute its value; 
otherwise substitute word. 
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${parameter : -word} 

If parameter is not set or is null, then set it to word; the value of 
the parameter is then substituted. Positional parameters may not 
be assigned to in this way. 

%{parameter : Iword} 

If parameter is set and is not a null argument, substitute its value; 
otherwise, print word and exit from the shell. If word is omitted, 
the message ' 'parameter null or not set' ' is printed. 

^{parameter :+word] 

If parameter is set and is not a null argument, substitute word; oth- 
erwise substitute nothing. In the above, word is not evaluated 
unless it is to be used as the substituted string, so that in the fol- 
lowing example, pwd is executed only if d is not set or is null: 

echo ${d:- v pwd v } 

If the colon (:) is omitted from the above expressions, then the shell 
only checks whether parameter is set. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal 

- Flags supplied to the shell on invocation or by the set command 

? The decimal value returned by the last synchronously executed 
command 

$ The process number of this shell 

! The process number of the last background command invoked 

The following parameters are used by the shell: 

CDPATH 

Defines search path for the cd command. See the section Special 
Commands, "cd". 

HOME 

The default argument (home directory) for the cd command 
PATH 

The search path for commands (see Execution below) 
MAIL 

If this variable is set to the name of a mail file, then the shell 
informs the user of the arrival of mail in the specified file 
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MAILCHECK 

This parameter specifies how often (in seconds) the shell will 
check for the arrival of mail in the files specified by the 
MAILPATH or MAIL parameters. The default value is 600 
seconds (10 minutes). If set to 0, the shell will check before each 
prompt. 

MAILPATH 

A colon (:) separated list of file names. If this parameter is set, the 
shell informs the user of the arrival of mail in any of the specified 
files. Each file name can be followed by % and a message that 
will be printed when the modification time changes. The default 
message is you have mail. 

PS1 

Primary prompt string, by default "$ " 
PS2 

Secondary prompt string, by default "> " 

IFS 

Internal field separators, normally space, tab, and newline 
SHACCT 

If this parameter is set to the name of a file writable by the user, 
the shell will write an accounting record in the file for each shell 
procedure executed. Accounting routines such as acctcom(ADM) 
and accton(ADM) can be used to analyze the data collected. This 
feature does not work with all versions of the shell. 

SHELL 

When the shell is invoked, it scans the environment (see Environ- 
ment below) for this name. If it is found and there is an 'r' in the 
file name part of its value, the shell becomes a restricted shell. 

The shell gives default values to PATH, PS1, PS2, and IFS, while 
HOME and MAIL are not set at all by the shell (although HOME is set 
by login (M)). 



Blank Interpretation 

After parameter and command substitution, the results of substitution 
are scanned for internal field separator characters (those found in IFS) 
and split into distinct arguments where such characters are found. 
Explicit null arguments (" " or ' ') are retained. Implicit null argu- 
ments (those resulting from parameters that have no values) are 
removed. 
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Filename Generation 

Following substitution, each command word is scanned for the char- 
acters *, ?, and [ . If one of these characters appears, the word is 
regarded as a pattern . The word is replaced with alphabetically sorted 
filenames that match the pattern. If no filename is found that matches 
the pattern, the word is left unchanged. The character . at the start of a 
filename or immediately following a /, as well as the character / itself, 
must be matched explicitly. These characters and their matching pat- 
terns are: 

* Matches any string, including the null string. 

? Matches any single character. 

[...] 

Matches any one of the enclosed characters. A pair of characters 
separated by - matches any character lexically between the pair, 
inclusive. If the first character following the opening bracket ([) is 
an exclamation mark (!), then any character not enclosed is 
matched. 



Quoting 

The following characters have a special meaning to the shell and 
cause termination of a word unless quoted: 

;&()!"<> newline space tab 

A character may be quoted (i.e., made to stand for itself) by preceding 
it with a V The pair \newline is ignored. All characters enclosed 
between a pair of single quotation marks ( except a single quota- 
tion mark, are quoted. Inside double quotation marks (" "), parameter 
and command substitution occurs and \ quotes the characters \, v , 
and $. "$*" is equivalent to "$1 $2 whereas "$<S>" is 

equivalent to "$1" "$2" ... 



Prompting 

When used interactively, the shell prompts with the value of PS1 
before reading a command. If at any time a newline is typed and 
further input is needed to complete a command, the secondary prompt 
(i.e., the value of PS2) is issued. 
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Spelling Checker 



When using cd(C) the shell checks spelling. For example, if you 
change to a different directory using cd and misspell the directory 
name, the shell repsonds with an alternative spelling of an existing 
directory. Enter "y" and press RETURN (or just press RETURN) to 
change to the offered directory. If the offered spelling is incorrect, 
enter "n", then retype the command line. In this example the sh(C) 
response is boldfaced: 

$ cd /usr/spol/uucp 
cd /usr/spool/uucp?y 
ok 



Input/Output 

Before a command is executed, its input and output may be redirected 
using a special notation interpreted by the shell. The following may 
appear anywhere in a simple-command or may precede or follow a 
command. They are not passed on to the invoked command; substitu- 
tion occurs before word or digit is used: 

<word Use file word as standard input (file descriptor 0). 



>word Use file word as standard output (file descriptor 1). 

If the file does not exist, it is created; otherwise, it is 
truncated to zero length. 

~3>word Use file word as standard output. If the file exists, 

output is appended to it (by first seeking the 
end-of-file); otherwise, the file is created. 

<k[ - ]word The shell input is read up to a line that is the same as 
word, or to an end-of-file. The resulting document 
becomes the standard input. If any character of word 
is quoted, no interpretation is placed upon the char- 
acters of the document; otherwise, parameter and 
command substitution occurs, (unescaped) \newline 
is ignored, and \ must be used to quote the characters 
\, $, v , and the first character of word. If - is 
appended to «*; , all leading tabs are stripped from 
word and from the document. 



<&digit The standard input is duplicated from file descriptor 

digit (see dup(S)). Similarly for the standard output 
using >. 

<&- The standard input is closed. Similarly for the stan- 

dard output using >. 
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If one of the above is preceded by a digit, the file descriptor created is 
that specified by the digit (instead of the default or 1). For example: 

... 2>&1 

creates file descriptor 2 that is a duplicate of file descriptor 1 . 

If a command is followed by &, the default standard input for the 
command is the empty file /dev/null. Otherwise, the environment for 
the execution of a command contains the file descriptors of the invok- 
ing shell as modified by input/output specifications. 



Environment 

The environment (see environ (M)) is a list of name-value pairs that is 
passed to an executed program in the same way as a normal argument 
list. The shell interacts with the environment in several ways. On 
invocation, the shell scans the environment and creates a parameter 
for each name found, giving it the corresponding value. Executed 
commands inherit the same environment. If the user modifies the 
values of these parameters or creates new ones, none of these affect 
the environment unless the export command is used to bind the shell's 
parameter to the environment. The environment seen by any executed 
command is composed of any unmodified name-value pairs originally 
inherited by the shell, minus any pairs removed by unset, plus any 
modifications or additions, all of which must be noted in export com- 
mands. 

The environment for any simple -command may be augmented by 
prefixing it with one or more assignments to parameters. Thus: 

TERM=450 cmd args 

and 

(export TERM; TERM=450; cmd args) 

are equivalent (as far as the above execution of cmd is concerned). 

If the -k flag is set, all keyword arguments are placed in the environ- 
ment, even if they occur after the command name. 



Signals 

The INTERRUPT and QUIT signals for an invoked command are 
ignored if the command is followed by &; otherwise signals have the 
values inherited by the shell from its parent, with the exception of sig- 
nal 1 1 . See the trap command below. 
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Execution 

Each time a command is executed, the above substitutions are carried 
out. If the command name does not match a Special Command, but 
matches the name of a defined function, the function is executed in the 
shell process (note how this differs from the execution of shell pro- 
cedures). The positional parameters $1, $2, ... are set to the arguments 
of the function. If the command name matches neither a Special Com- 
mand nor the name of a defined function, a new process is created and 
an attempt is made to execute the command via exec(S). 

The shell parameter PATH defines the search path for the directory 
containing the command. Alternative directory names are separated 
by a colon (:). The default path is :/bin:/usr/bin (specifying the 
current directory, /bin, and /usr/bin, in that order). Note that the 
current directory is specified by a null pathname, which can appear 
immediately after the equal sign or between the colon delimiters any- 
where else in the path list. If the command name contains a /, then the 
search path is not used. Otherwise, each directory in the path is 
searched for an executable file. If the file has execute permission but 
is not an a.out file, it is assumed to be a file containing shell com- 
mands. A subshell (i.e., a separate process) is spawned to read it. A 
parenthesized command is also executed in a subshell. 

Shell procedures are often used by users running the csh. However, if 
the first character of the procedure is a # (comment character), csh 
assumes the procedure is a csh script, and invokes /bin/ csh to execute 
it. Always start sh procedures with some other character if csh users 
are to run the procedure at any time. This invokes the standard shell 
Ibinlsh . 

The location in the search path where a command was found is 
remembered by the shell (to help avoid unnecessary execs later). If 
the command was found in a relative directory, its location must be 
re-determined whenever the current directory changes. The shell for- 
gets all remembered locations whenever the PATH variable is changed 
or the hash -r command is executed (see below). 



Special Commands 

Input/output redirection is permitted for these commands: 

: No effect; the command does nothing. A zero exit code is 
returned. 

. file 

Reads and executes commands from file and returns. The search 
path specified by PATH is used to find the directory containing file . 
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break [ n ] 

Exits from the enclosing for or while loop, if any. If n is specified, 
it breaks n levels. 

continue [ n ] 

Resumes the next iteration of the enclosing for or while loop. If n 
is specified, it resumes at the «-th enclosing loop. 

cd [ arg ] 

Changes the current directory to arg. The shell parameter HOME 
is the default arg. The shell parameter CDPATH defines the 
search path for the directory containing arg. Alternative directory 
names are separated by a colon (:). The default path is <null> 
(specifying the current directory). Note that the current directory 
is specified by a null path name, which can appear immediately 
after the equal sign or between the colon delimiters anywhere else 
in the path list. If arg begins with a /, the search path is not used. 
Otherwise, each directory in the path is searched for arg. 

If the shell is reading its commands from a terminal, and the specified 
directory does not exist (or some component cannot be searched), 
spelling correction is applied to each component of directory, in a 
search for the "correct' ' name. The shell then asks whether or not to 
try and change directory to the corrected directory name; an answer of 
n means "no", and anything else is taken as "yes". 

echo [ arg ] 

Writes arguments separated by blanks and terminated by a newline 
on the standard output. Arguments may be enclosed in quotes. 
Quotes are required so that the shell correctly interprets these spe- 
cial escape sequences: 

\b Backspace 

\c Prints line without newline. 

\f Form feed 

\n Newline 

\r Carriage return 

\t Tab 

\v Vertical tab 

\\ Backslash 

\n The 8-bit character whose ASCII code is the 1, 2 or 3-digit octal 
number n must start with a zero 

eval [ arg ... ] 

The arguments are read as input to the shell and the resulting 
command(s) executed. 

exec [ arg ... ] 

The command specified by the arguments is executed in place of 
this shell without creating a new process. Input/output arguments 
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may appear and, if no other arguments are given, cause the shell 
input/output to be modified. 

exit [ n ] 

Causes a shell to exit with the exit status specified by n. If n is 
omitted, the exit status is that of the last command executed. An 
end-of-file will also cause the shell to exit. 

export [ name ... ] 

The given names are marked for automatic export to the environ- 
ment of subsequently executed commands. If no arguments are 
given, a list of all names that are exported in this shell is printed. 

hash [ -r ] [ name ... ] 

For each name, the location in the search path of the command 
specified by name is determined and remembered by the shell. The 
-r option causes the shell to forget all remembered locations. If no 
arguments are given, information about remembered commands is 
presented. Hits is the number of times a command has been 
invoked by the shell process. Cost is a measure of the work 
required to locate a command in the search path. There are certain 
situations which require that the stored location of a command be 
recalculated. Commands for which this will be done are indicated 
by an asterisk (*) adjacent to the hits information. Cost will be 
incremented when the recalculation is done. 

newgrp [ arg ... ] 

Equivalent to exec newgrp arg . . . 

pwd 

Print the current working directory. See pwd(C) for usage and 
description. 

read [ name . . . ] 

One line is read from the standard input and the first word is 
assigned to the first name, the second word to the second name, 
etc., with leftover words assigned to the last name. The return 
code is unless an end-of-file is encountered. 

readonly [ name ... ] 

The given names are marked readonly and the values of the these 
names may not be changed by subsequent assignment. If no argu- 
ments are given, a list of all readonly names is printed. 

return [ n ] 

Causes a function to exit with the return value specified by n. If n 
is omitted, the return status is that of the last command executed. 

set [ -eknuvx [ arg ...] ] 

-e If the shell is noninteractive, exits immediately if a command 
exits with a nonzero exit status. 

-f Disables file name generation. 

-h Locates and remembers function commands as functions are 
defined (function commands are normally located when the 
function is executed). 
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-k Places all keyword arguments in the environment for a com- 
mand, not just those that precede the command name. 

-n Reads commands but does not execute them. 

-u Treats unset variables as an error when substituting. 

-v Prints shell input lines as they are read. 

-x Prints commands and their arguments as they are executed. 
Although this flag is passed to subshells, it does not enable trac- 
ing in those subshells. 

-- Does not change any of the flags; useful in setting $1 to -. 

Using + rather than - causes these flags to be turned off. These 
flags can also be used upon invocation of the shell. The current set 
of flags may be found in $-. The remaining arguments are posi : 
tional parameters and are assigned, in order, to $1, $2, ... If no 
arguments are given, the values of all names are printed. 

shift 

The positional parameters from $2 . . . are renamed $1 . . . 
test 

Evaluates conditional expressions. See test(C) for usage and 
description. 

times 

Prints the accumulated user and system times for processes run 
from the shell. 

trap [ arg ] [ n ] ... 

arg is a command to be read and executed when the shell receives 
signal(s) n. (Note that arg is scanned once when the trap is set and 
once when the trap is taken.) Trap commands are executed in 
order of signal number. The highest signal number allowed is 16. 
Any attempt to set a trap on a signal that was ignored on entry to 
the current shell is ineffective. An attempt to trap on signal 11 
(memory fault) produces an error. If arg is absent, all trap(s) n are 
reset to their original values. If arg is the null string, this signal is 
ignored by the shell and by the commands it invokes. If n is 0, the 
command arg is executed on exit from the shell. The trap com- 
mand with no arguments prints a list of commands associated with 
each signal number. 

type [ name ... ] 

For each name, indicate how it would be interpreted if used as a 
command name. 

ulimit [ [ -f ] n ] 

imposes a size limit of n blocks on files. 

-f imposes a size limit of n blocks on files written by child 
processes (files of any size may be read). Any user may 
decrease the file size limit, but only the super-user (root) can 
increase the limit. With no argument, the current limit is 
printed. 
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If no option is given and a number is specified, -f is assumed. 

unset [ name ... ] 

For each name, remove the corresponding variable or function. 
The variables PATH, PS1, PS2, MAILCHECK and IFS cannot be 
unset. 

umask [ ooo ] 

The user file-creation mask is set to the octal number ooo where o 
is an octal digit (see umask(C)). If ooo is omitted, the current 
value of the mask is printed. 

wait [ n ] 

Waits for the specified process to terminate, and reports the termi- 
nation status. If n is not given, all currently active child processes 
are waited for. The return code from this command is always 0. 



Invocation 



If the shell is invoked through exec (S) and the first character of argu- 
ment is -, commands are initially read from /etc/profile and then 
from $HOME/.profile, if such files exist. Thereafter, commands are 
read as described below, which is also the case when the shell is 
invoked as /bin/sh. The flags below are interpreted by the shell on 
invocation only; note that unless the -c or -s flag is specified, the first 
argument is assumed to be the name of a file containing commands, 
and the remaining arguments are passed as positional parameters to 
that command file: 

-c string If the -c flag is present, commands are read from string . 

-s If the -s flag is present or if no arguments remain, com- 

mands are read from the standard input. Any remaining 
arguments specify the positional parameters. Shell output 
is written to file descriptor 2. 

-t If the -t flag is present, a single command is read and exe- 

cuted, and the shell exits. This flag is intended for use by 
C programs only and is not useful interactively. 

-i If the -i flag is present or if the shell input and output are 

attached to a terminal, this shell is interactive . In this 
case, TERMINATE is ignored (so that kill does not kill 
an interactive shell) and INTERRUPT is caught and 
ignored (so that wait is interruptible). In all cases, QUIT 
is ignored by the shell. 

-r If the -r flag is present, the shell is a restricted shell (see 

rsh(Q). 

The remaining flags and arguments are described under the set com- 
mand above. 
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Exit Status 



Errors detected by the shell, such as syntax errors, cause the shell to 
return a nonzero exit status. If the shell is being used noninterac- 
tively, execution of the shell file is abandoned. Otherwise, the shell 
returns the exit status of the last command executed. See the exit com- 
mand above. 



Files 



/etc/profile system default profile if none is present 

$HOME/.profile read by login shell at login 

/tmp/sh* temporary file for « 

/dev/null source of empty file 



See Also 

cd(C), env(C), login(M), newgrp(C), rsh(C), test(C), umask(C), 

dup(S), exec(S), fork(S), pipe(S), signal(S), umask(S), wait(S), 
a.out(F), profile(M), environ(M) 



Notes 

The command readonly (without arguments) produces the same out- 
put as the command export. 

If <*; is used to provide standard input to an asynchronous process 
invoked by &, the shell gets mixed up about naming the input docu- 
ment; a garbage file /tmp/sh* is created and the shell complains about 
not being able to find that file by another name. 

If a command is executed, and a command with the same name is 
installed in a directory in the search path before the directory where 
the original command was found, the shell will continue to exec the 
original command. Use the hash command to correct this situation. 

If you move the current directory or one above it, pwd may not give 
the correct response. Use the cd command with a full path name to 
correct this situation. 

When a sh(C) user logs in, the system reads and executes commands 
in /etc/profile before executing commands in the user's 
$HOMEI. profile. You can, therefore, modify the environment for all 
sh(C) users on the system by editing /etc/profile. 
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Name 

shl - Shell layer manager 



Syntax 
shl 



Description 

shl allows a user to interact with more than one shell from a single ter- 
minal. The user controls these shells, known as layers , using the com- 
mands described below. 

The current layer is the layer that can receive input from the key- 
board. Other layers attempting to read from the keyboard are blocked. 
Output from multiple layers is multiplexed onto the terminal. To have 
the output of a layer blocked when it is not current, the stty(C) option 
loblk may be set within the layer. 

The stty character swtch (set to "Z if NUL) is used to switch control to 
shl from a layer, shl has its own prompt, ?s>, to help distinguish it 
from a layer. 

A layer is a shell that has been bound to a virtual tty device 
(/dev/sxt???). The virtual device can be manipulated like a real tty 
device using stty(C) and ioctl(S). Each layer has its own process 
group id. 



Definitions 

A name is a sequence of characters delimited by a blank, tab or new- 
line. Only the first eight characters are significant. The names (1) 
through (7) cannot be used when creating a layer. They are used by 
shl when no name is supplied. They may be abbreviated to just the 
digit. 



Commands 

The following commands may be issued from the shl prompt level. 
Any unique prefix is accepted. 

create name 

Create a layer called name and make it the current layer. If no 
argument is given, a layer will be created with a name of the form 
(#) where # is the last digit of the virtual device bound to the layer. 
The shell prompt variable PS1 is set to the name of the layer fol- 
lowed by a space, or, if superuser, the name followed by a sharp (#) 
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and a space. A maximum of seven layers can be created. 

block name [ name ... ] 

For each name, block the output of the corresponding layer when it 
is not the current layer. This is equivalent to setting the stty option 
loblk within the layer. 

delete name name . . . 

For each name, delete the corresponding layer. All processes in 
the process group of the layer are sent the SIGHUP signal (see sig- 
nal{2)). 

help (or ?) 

Print the syntax of the shl commands. 

layers -1 name . . . 

For each name, list the layer name and its process group. The -1 
option produces a /«(l)-like listing. If no arguments are given, 
information is presented for all existing layers. 

resume name 

Make the layer referenced by name the current layer. If no argu- 
ment is given, the last existing current layer will be resumed. 

toggle 

Resume the layer that was current before the last current layer. 

unblock name [ name ... ] 

For each name, do not block the output of the corresponding layer 
when it is not the current layer. This is equivalent to setting the 
stty option loblk within the layer. 

quit 

Exit shl . All layers are sent the SIGHUP signal. 
name 

Make the layer referenced by name the current layer. 



Files 



/dev/sxt??? 
$SHELL 



Virtual tty devices 

Variable containing path name of the shell to 
use (default is /bin/sh). 



See Also 



ioctl(S), mkdev(ADM), sh(C), signal(S), stty(C), sxt(M) 
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Note 

It is inadvisable to kill shl. 

If shl does not ran properly on a particular terminal, you may have to 
set istrip for that terminal's line by entering the following command 
at the terminal: 

stty istrip 

By default, XENIX is configured for one shell layer session at a time. 
To increase this single session limit, enter the command: 

mkdev shl 

This executes a script which prompts you for the number of sessions 
desired. The script also allows you to relink the kernel. The new ses- 
sion limit becomes effective after the kernel is rebooted. (For more 
information, see mkdev(XDM).) 
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Name 

sleep - Suspends execution for an interval. 



SLEEP (C) 



Syntax 
sleep time 

Description 

sleep suspends execution for time seconds. It is used to execute a 
command after a certain amount of time as in: 

(sleep 105; command)& 

or to execute a command every so often, as in: 

while true 
do 

command 
sleep 37 

done 

See Also 

alarm(S), sleep(S) 

Notes 

It is recommended that time be less than 65536 seconds. 
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Name 

sort - Sorts and merges files. 



Syntax 

sort [-emu] [-ooutput] [-ykmem] [-zrecsz] [-dfiMnr] [-btx] [+posl] 
[-pos2] [files] 



Description 

sort sorts lines of all the named files together and writes the result on 
the standard output. The standard input is read if - is used as a file 
name or if no input files are named. 

Comparisons are based on one or more sort keys extracted from each 
line of input. By default, there is one sort key, the entire input line, 
and ordering is lexicographic by bytes in the machine's collating 
sequence. 

The following options alter the default behavior: 

-c Check that the input file is sorted according to the ordering 
rules; give no output unless the file is out of sort. 

-m Merge only, the input files are already sorted. 

-u Unique: suppress all but one in each set of lines having equal 
keys. This option can result in unwanted characters placed at 
the end of the sorted file. 

-ooutput 

The argument given is the name of an output file to use instead 
of the standard output. This file may be the same as one of the 
inputs. There may be optional blanks between -o and output. 

-ykmem 

The amount of main memory used by the sort has a large impact 
on its performance. Sorting a small file in a large amount of 
memory is a waste. If this option is omitted, sort begins using a 
system default memory size, and continues to use more space as 
needed. If this option is presented with a value, kmem , sort will 
start using that number of kilobytes of memory, unless the 
administrative minimum or maximum is violated, in which case 
the corresponding extremum will be used. Thus, -yO is 
guaranteed to start with minimum memory. By convention, -y 
(with no argument) starts with maximum memory. 
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-zrecsz 

The size of the longest line read is recorded in the sort phase so 
buffers can be allocated during the merge phase. If the sort 
phase is omitted via the -c or -m options, a popular system 
default size will be used. Lines longer than the buffer size will 
cause sort to terminate abnormally. Supplying the actual 
number of bytes in the longest line to be merged (or some larger 
value) will prevent abnormal termination. 

The following options override the default ordering rules. 

-d "Dictionary" order: only letters, digits and blanks (spaces and 
tabs) are significant in comparisons. 

-f Fold lower case letters into upper case. 

-i Ignore characters outside the ASCII range 040-0176 in non- 
numeric comparisons. 

-M Compare as months. The first three non-blank characters of the 
field are folded to upper case and compared so that "JAN" < 
"FEB" < ... < "DEC". Invalid fields compare low to "JAN". 
The -M option implies the -b option (see below). 

-n An initial numeric string, consisting of optional blanks, an 
optional minus sign, and zero or more digits with optional 
decimal point, is sorted by arithmetic value. The -n option 
implies the -b option (see below). Note that the -b option is 
only effective when restricted sort key specifications are in 
effect. 

-r Reverse the sense of comparisons. 

When ordering options appear before restricted sort key specifications, 
the requested ordering rules are applied globally to all sort keys. 
When attached to a specific sort key (described below), the specified 
ordering options override all global ordering options for that key. 

The notation +posl -pos2 restricts a sort key to one beginning at posl 
and ending at posl. The characters at positions posl and posl are 
included in the sort key (provided that posl does not precede posl ). A 
missing -posl means the end of the line. 
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Specifying posl and pos2 involves the notion of a field (a minimal 
sequence of characters followed by a field separator or a newline). By 
default, the first blank (space or tab) of a sequence of blanks acts as 
the field separator. All blanks in a sequence of blanks are considered 
to be part of the next field; for example, all blanks at the beginning of 
a line are considered to be part of the first field. The treatment of field 
separators can be altered using the options: 

-tx Use x as the field separator character; x is not considered to be 
part of a field (although it may be included in a sort key). Each 
occurrence of x is significant (e.g., xx delimits an empty field). 

-b Ignore leading blanks when determining the starting and ending 
positions of a restricted sort key. If the -b option is specified 
before the first +posl argument, it will be applied to all +posl 
arguments. Otherwise, the b flag may be attached indepen- 
dently to each +posl or -pos2 argument (see below). 

Posl and pos2 each have the form m.n optionally followed by one or 
more of the flags b, d, f, i, n, or r. A starting position specified by 
+m.n is interpreted to mean the «+lst character in the m+lst field. A 
missing .n means .0, indicating the first character of the m+lst field. If 
the b flag is in effect, n is counted from the first non-blank in the 
m+lst field; +m.0b refers to the first non-blank character in the m+lst 
field. 

A last position specified by -m.n is interpreted to mean the nth charac- 
ter (including separators) after the last character of the mth field. A 
missing .n means .0, indicating the last character of the mth field. If 
the b flag is in effect, n is counted from the last leading blank in the 
m+lst field; -m.lb refers to the first non-blank in the m+lst field. 

When there are multiple sort keys, later keys are compared only after 
all earlier keys compare equal. Lines that otherwise compare equal 
are ordered with all bytes significant. 

Examples 

Sort the contents of infile with the second field as the sort key: 
sort +1-2 infile 

Sort, in reverse order, the contents of infilel and infile2 , placing the 
output in outfile and using the first character of the second field as the 
sort key: 

sort -r -o outfile +1.0-1.2 infilel infile2 

Sort, in reverse order, the contents of infilel and infilel using the first 
non-blank character of the second field as the sort key: 
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sort -r + 1 .Ob - 1 . 1 b infile 1 infile2 

Print the password file (passwd(F)) sorted by the numeric user ID (the 
third colon-separated field): 

sort -t: +2n -3 /etc/passwd 

Print the lines of the already sorted file infile , suppressing all but the 
first occurrence of lines having the same third field (the options -um 
with just one input file make the choice of a unique representative 
from a set of equal lines predictable): 

sort -um +2 -3 infile 



Files 

/usr/tmp/stm??? 



See Also 

comm(C), join(C), uniq(C) 



Diagnostics 

Comments and exits with non-zero status for various trouble condi- 
tions (e.g., when input lines are too long), and for disorders discovered 
under the -c option. When the last line of an input file is missing a 
newline character, sort appends one, prints a warning message, and 
continues. 
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Name 

split - Splits a file into pieces. 

Syntax 

split [ -n ] [ file [ name ] ] 

Description 

split reads file and writes it in as many n-line pieces as necessary 
(default 1000), onto a set of output files. The name of the first output 
file is name with aa appended, and so on lexicographically. If no out- 
put name is given, x is default. 

If no input file is given, or if a dash (-) is given instead, the standard 
input file is used. 

See Also 

bfs(C), csplit(C) 
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Name 

stty - Sets the options for a terminal. 



Syntax 

stty [ -a ] [ -g ] [ options ] 



Description 

stty sets certain terminal I/O options for the device that is the current 
standard input; without arguments, it reports the settings of certain 
options. With the -a option, stty reports all of the option settings; with 
the -g option, it reports current settings in a form that can be used as 
an argument to another stty command. Detailed information about the 
modes listed in the first four groups may be found in termioQA). 
options in the last group are implemented using options in the previ- 
ous groups. Refer to vidi(C) for hardware specific information that 
describes control modes for the video monitor and other display dev- 
ices. 



Common Control Modes 

parenb (-parenb) 

Enables (disables) parity generation and detection. 

parodd (-parodd) 

Selects odd (even) parity. 

cs5 cs6 cs7 cs8 

Selects character size (see tty(M)). 

Hangs up phone line immediately. 

50 75 110 134 150 200 300 600 
1200 1800 2400 4800 9600 exta 

Sets terminal baud rate to the number given, if possible. 

hupcl (-hupcl) 

Hangs up (does not hang up) phone connection on last close. 

hup (-hup) 

Same as hupcl (-hupcl). 

cstopb (-cstopb) 

Uses two(one) stop bits per character. 
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cread (-cread) 

Enables (disables) the receiver. 

clocal (-clocal) 

Assumes a line without (with) modem control. 

ctsflow (-ctsflow) 

Enables CTS protocol for a modem line. 

rtsflow (-rtsflow) 

Enables RTS signaling for a modem line. 



Input Modes 

ignbrk (-ignbrk) 

Ignores (does not ignore) break on input. 

brkint (-brkint) 

Signals (does not signal) INTERRUPT on break. 

ignpar (-ignpar) 

Ignores (does not ignore) parity errors. 

parmrk (-parmrk) 

Marks (does not mark) parity errors (see tty(M)). 

inpck (-inpck) 

Enables (disables) input parity checking. 

istrip (-istrip) 

Strips (does not strip) input characters to 7 bits. 

inlcr (-inlcr) 

Maps (does not map) NL to CR on input. 

igncr (-igncr) 

Ignores (does not ignore) CR on input. 

icrnl (-icrnl) 

Maps (does not map) CR to NL on input. 

iuclc (-iuclc) 

Maps (does not map) uppercase alphabetics to lowercase on input, 
ixon (-ixon) 

Enables (disables) START/STOP output control. Output is stopped ( 
by sending an ASCII DC3 and started by sending an ASCII DC1. 

ixany (-ixany) 

Allows any character (only DC1) to restart output. 
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ixoff (-ixoff) 

Requests that the system send (not send) START/STOP characters 
when the input queue is nearly empty/full. 



Output Modes 
opost (-opost) 

Post-processes output (does not post-process output; ignores all 
other output modes). 

olcuc (-olcuc) 

Maps (does not map) lowercase alphabetics to uppercase on out- 
put. 

onlcr (-onlcr) 

Maps (does not map) NL to CR-NL on output. 

ocrnl (-ocrnl) 

Maps (does not map) CR to NL on output. 

onocr (-onocr) 

Does not (does) output CRs at column zero. 

onlret (-onlret) 

On the terminal NL performs (does not perform) the CR function. 

ofill (-ofill) 

Uses fill characters (use timing) for delays. 

ofdel (-ofdel) 

Fill characters are DELETES (NULs). 

crO crl cr2 cr3 

Selects style of delay for RETURNS (see tty(M)). 

nlO nil 

Selects style of delay for LINEFEEDS (see tty(M)). 

tabO tabl tab2 tab3 

Selects style of delay for horizontal TABs (see tty(M)). 

bsO bsl 

Selects style of delay for BACKSPACES (see tty(M)). 
ffOffl 

Selects style of delay for FORMFEEDS (see tty(M)). 
vtO vtl 

Selects style of delay for Vertical TABs (see tty(M)). 
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Local Modes 
isig (-isig) 

Enables (disables) the checking of characters against the special 
control characters INTERRUPT and QUIT. 

icanon (-icanon) 

Enables (disables) canonical input (ERASE and KILL processing). 

xcase (-xcase) 

Canonical (unprocessed) upper/lowercase presentation. 

echo (-echo) 

Echoes back (does not echo back) every character typed, 
echoe (-echoe) 

Echoes (does not echo) ERASE character as a SPACEBAR string. 
Note: this mode will erase the ERASE character on many CRT ter- 
minals; however, it does not keep track of column position and, as 
a result, may be confusing on escaped characters, TABs, and 
BACKSPACES. 

echok (-echok) 

Echoes (does not echo) NL after KILL character. 

Ifkc (-like) 

The same as echok (-echok); obsolete. 

echonl (-echonl) 

Echoes (does not echo) NL. 

noflsh (-noflsh) 

Disables (enables) flush after INTERRUPT or QUIT. 

stwrap (-stwrap) 

Disables (enables) truncation of lines longer than 79 characters on 
a synchronous line. 

stflush (-stflush) 

Enables (disables) flush on a synchronous line after every write (S). 

stappl (-stappl) 

Uses application (line) mode on a synchronous line. 
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Control Assignments 

control-character-C 

control-character C Sets control-character to C, where control- 
character is ERASE, KILL, INTERRUPT, QUIT, EOF, EOL. erase, 
kill, interrupt, quit, eof, or eol. If C is preceded by a caret Q 
(escaped from the shell), then the value used is the corresponding 
CTRL character (e.g., "T>" is a CTRL-D ); ""?" is interpreted as 
DELETE and ""-"is interpreted as undefined. 

min /, time / (0</<127) 

When -icanon is set, and one character has been received, read 
requests are not satisfied until at least min characters have been 
received or the timeout value time has expired and one character 
has been received. See tty(C). 

line i 

Sets the line discipline to / (0 < / < 127 ). There are currently no 
line disciplines implemented. 



Combination Modes 

evenp or parity 

Enables parenb and cs7. 

oddp 

Enables parenb, cs7, and parodd. 

-parity, -evenp, or -oddp 

Disables parenb, and sets cs8. 

raw (-raw or cooked) 

Enables (disables) raw input and output (no ERASE, KILL, INTER- 
RUPT, QUIT, EOT, or output post-processing). 

nl (-nl) 

Unsets (sets) icrnl, onlcr. In addition -nl unsets inlcr, igncr, 
ocrnl, and onlret. 

lease (-lease) 

Sets (unsets) xcase, iuclc, and oleuc. 

LCASE (-LCASE) 

Same as lease (-lease). 

tabs (-tabs or tab3) 

Preserves (expands to spaces) tabs when printing. 

ek Resets ERASE and KILL characters back to normal CTRL-H and 
CTRL-U. 
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sane 

Resets all modes to some reasonable values. Useful when a 
terminal's settings have been hopelessly scrambled. 

term 

Sets all modes suitable for the terminal type, TERM, where TERM 
is one of tty33, tty37, vt05, tn300, ti700, or tek. 



See Also 

console(M), ioctl(S), vidi(C), tty(M), termio(M) 



Notes 

Many combinations of options make no sense, but no checking is per- 
formed. 



May 16, 1988" 



Page 6 



SU(C) 



SU(C) 



Name 

su - Makes the user a super-user or another user. 



Syntax 

su [ - ] [ name [ arg . . . ] ] 



Description 

su allows you to become another user without logging off. The 
default user name is root (i.e., super-user). 

To use su, the appropriate password must be supplied (unless you are 
already a super-user). If the password is correct, su will execute a 
new shell with the real and effective user ID set to that of the specified 
user. The new shell will be the optional program named in the shell 
field of the specified user's password file (/bin/sh if none is specified 
(see jh(C)). To restore normal user ID privileges, press EOF (Ctrl-D) 
to the new shell. 

Any additional arguments given on the command line are passed to 
the program invoked as the shell. When using programs like sh(C), an 
arg of the form -c string executes string via the shell and an arg of -r 
gives the user a restricted shell. 

The following statements are true only if the optional program named 
in the shell field of the specified user's password file entry is like 
sh(C). If the first argument to su is a -, the environment is changed to 
what would be expected if the user actually logged in as the specified 
user. This is done by invoking the program used as the shell with an 
argO value whose first character is -, thus causing first the system's 
profile (/etc/profile) and then the specified user's profile (.profile in 
the new HOME directory) to be executed. Otherwise, the environ- 
ment is passed along with the possible exception of $PATH, which is 
set to /bin:/etc:/usr/bin for root. Note that if the optional program 
used as the shell is /bin/sh, the user's .profile can check argO for -sh 
or -su to determine if it was invoked by loginQA) or su(C), respec- 
tively. If the user's program is other than /bin/sh, then .profile is 
invoked with an argO of -program by both login(M) and su(C). 
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The file /etc/default/su can be used to control several aspects of how 
su is used. Several entries can be placed in /etc/default/su: 

SULOG Name of log file to record all attempts to use su. Usually 
/usr/adm/sulog. If not set, no logfile is kept. (See example 
below.) 

PATH The PATH environment variable to set for non-root users. 

If not set, it defaults to ":/bin:/usr/bin." The current 
PATH environment variable is ignored. 

SUPATH When invoked by root, the path is set by default to 
"/bin:/usr/bin:/etc", unless this variable is defined., The 
current PATH is ignored. 

CONSOLE Attempts to use su are logged to the named device, 
independently of SULOG. 

For example, if you want to log all attempts by users to become root, 
create the file /etc/default/su. In this file, place a string similar to: 
SULOG=/usr/adm/sulog This causes all attempts by any user to switch 
user IDs to be recorded in the file /usr/adm/sulog. This filename is 
arbitrary. The su logfile records the original user, the UID of the su 
attempt, and the time of the attempt. If the attempt is successful, a 
plus sign (+) is placed on the line describing the attempt. A minus 
sign (-) indicates an unsuccessful attempt. 

Examples 

To become user bin while retaining your previously exported environ- 
ment, enter: 

su bin 

To become user bin but change the environment to what would be 
expected if bin had originally logged in, enter: 

su - bin 

To execute command with the temporary environment and permissions 
of user bin, enter: 

su - bin -c "command args' ' 



Files 

/etc/passwd The system password file 

/etc/default/su Optional file containing control options 

/etc/profile The system profile 

$HOME/.profile The user profile 
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See Also 

env(C), environ(M), login(M), passwd(F), profile(M), sh(C) 
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Name 

sum - Calculates checksum and counts blocks in a file. 

Syntax 

sum [ -r ] file 

Description 

sum calculates and prints a 16-bit checksum for the named file, and 
also prints the number of BSIZE blocks in the file. It is typically used 
to look for bad spots, or to validate a file communicated over a 
transmission line. The option -r causes an alternate algorithm to be 
used in computing the checksum. 

See Also 

cmchk(C), machine(M), wc(C) 

Diagnostics 

"Read error" is indistinguishable from end-of-file on most devices; 
check the block count. 

Notes 

Refer to machine (M) or use the cmchk (C) utility to determine BSIZE 
for your system. 
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Name 

tail - Delivers the last part of a file. 



Syntax 

tail [ +[number][lbc] [ -f ] ] [ file ] 



Description 

tail copies the named file to the standard output beginning at a desig- 
nated place. If no file is named, the standard input is used. 

Copying begins at distance +number from the beginning, or -number 
from the end of the input (if number is null, the value 10 is assumed). 
Number is counted in units of lines, blocks, or characters, according to 
the appended option 1, b, or c. When no units are specified, counting 
is by lines. 

With the -f ("follow") option, if the input file is not a pipe, the pro- 
gram will not terminate after the line of the input file has been copied, 
but will enter an endless loop, wherein it sleeps for a second and then 
attempts to read and copy further records from the input file. Thus it 
may be used to monitor the growth of a file that is being written by 
some other process. For example, the command: 

tail -f file 

will print the last ten lines of file, followed by any lines that are 
appended to file between the time tail is initiated and killed. 



See Also 

dd(C) 



Notes 

Tails relative to the end of the file are kept in a buffer, and thus are 
limited in length. Unpredictable results can occur if character special 
files are "tailed". 
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Name 

tape - Magnetic tape maintenance program. 



Syntax 

tape command [ devicefile ] 



Description 

tape sends commands and receives status to and from the tape subsys- 
tem. tape(RW) lists the drives supported. The available commands 
are listed below. 

amount 

Report amount of data in current or last transfer, 
erase 

Erase tape cartridge. Also retensions. 
reset 

Reset tape controller and tape drive. Clears error conditions and 
returns tape subsystem to power-up state. 

reten 

Retension tape cartridge. Should be used periodically to remedy 
slack tape problems. Tape slack can cause an unusually large 
number of tape errors. 

rewind 

Rewind to beginning of tape. 

rfm 

Wind tape forward to the next file mark, 
status 

The status output looks like this: 

status: status message 
soft errors: n 
underruns: m 

status message is a report of the current status of the drive; "no 
cartridge," "write protected," or "beginning of tape" are typical 
status messages. 

soft errors is the number of recoverable errors that occurred during 
the last tape operation. A recoverable error is one which is 
correctable by the drive or controller. An example of a non- 
recoverable "hard" error is an attempt to write to a write- 
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protected cartridge. Note that if the number of soft errors greatly 
exceeds the manufacturer's specifications, the drive may require 
service or replacement. 

underruns is the number of times the tape drive had to" stop and 
restart due to tape buffer underflows. Underruns are not an error 
indication, but that the data transfer did not occur at the drive's 
maximum data transfer rate. The number of overruns can be 
affected by system load. 

wfm Write a file mark at the current tape position. 

The amount and reset commands can be used while the tape is busy 
with other operations. The erase, reten, rewind, rfm, status and wfm 

commands wait until the current command has been completed before 
proceeding. 

When you are using the non-rewinding tape device or the tape com- 
mands rfm and wfm, the tape drive light remains on after die com- 
mand has been completed, indicating that more operations may be 
performed on the tape. The tape rewind command may be used to 
clear this condition. 

For more information on devicefiles, (listed below), see the 
tape (HW) manual page. 



Files 

/dev/rctO 

/dev/nrctO 

/dev/rct2 

/dev/nrct2 

/dev/rctmini 



See Also 

backup(C), cpio(C), dd(C), dump(C), restore(C), tape(HW), tar(C) 



Notes 

If you use the status command while the tape drive is busy, no mes- 
sage is displayed until the drive is free. 
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Syntax 

tapedump [-al-e] [-ol-h] [-btsnnum] tape_device output Jile 
Description 

tapedump dumps the contents of magnetic tapes according to the 
options specified. Options include conversion from input format to 
user specified output format, specification of input and output block- 
size, and the ability to specify that the dump begin at a specific start 
block on the tape and proceed for a specified number of blocks. 

Options 

Option Value 



tape_device The input tape device. 

-a Convert from EBCDIC input to ASCII output. 

-e Convert from ASCII input to EBCDIC output. 

-o Display tape output in octal format. 

-h Display tape output in hexadecimal format. 

-b num. skips n input records before starting dump. 

-t num Specify which tape file to begin dump from, 
where num is the tape file sequence number. 

-s num Specify tape block address from which to start dump. 

-n num Specify dump of only num blocks. 

output Jile The output filename; standard output is the default. 



Examples 

This command reads a tape starting at block 400 and outputs the 
results in hexadecimal format into a user specified file called 
/tmp/hex.dump: 
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tapedump -b400 -h IdevlrctO Itmplhexdump 

This command reads an EBCDIC tape and converts the standard out- 
put to ASCII: 

tapedump -a IdevlrctO 

See Also 

sysadmsh(ADM), dd(C), hd(C), od(C), tape(C) 
Notes 

The output file may be specified to be another tape device. 
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Name 

tar - Archives files. 



Syntax 

tar [ key ] [ files ] 



Description 

tar saves and restores files to and from an archive medium, which is 
typically a storage device such as floppy disk or tape, or a regular file. 
Its actions are controlled by the key argument. The key is a string of 
characters containing at most one function letter and possibly one or 
more function modifiers. Valid function letters are c, t, x, and e. 
Other arguments to the command are files (or directory names) speci- 
fying which files are to be backed up or restored. In all cases, appear- 
ance of a directory name refers to the files and (recursively) subdirec- 
tories of that directory. The r and u option cannot be used with tape 
devices. 

The function portion of the key is specified by one of the following 
letters: 

r The named files are written to the end of an existing archive. 

x The named files are extracted from the archive. If a named 

file matches a directory whose contents had been written 
onto the archive, this directory is (recursively) extracted. 
The owner, modification time, and mode are restored (if pos- 
sible). If no files argument is given, the entire contents of 
the archive are extracted. Note that if several files with the 
same name are on the archive, the last one overwrites all 
earlier ones. 

t The names of the specified files are listed each time that 

they occur on the archive. If no files argument is given, all 
the names on the archive are listed. 

u The named files are added to the archive if they are not 

already there, or if they have been modified since last writ- 
ten on that archive. 

c Creates a new archive; writing begins at the beginning of the 

archive, instead of after the last file. 
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The following characters may be used in addition to the letter that 
selects the desired function: 

0,...,7 This modifier selects the drive on which the archive is 
mounted. The default is found in the file /etc/default/tar. 

v Normally, tar does its work silently. The v (verbose) option 

causes it to display the name of each file it treats, preceded 
by the function letter. With the t function, v gives more 
information about the archive entries than just the name. 

w Causes tar to display the action to be taken, followed by the 

name of the file, and then wait for the user's confirmation. If 
a word beginning with y is given, the action is performed. 
Any other input means "no". 

f Causes tar to use the next argument as the name of the 

archive instead of the default device listed in 
/etc/default/tar. If the name of the file is a dash (-), tar 
writes to the standard output or reads from the standard 
input, whichever is appropriate. Thus, tar can be used as the 
head or tail of a pipeline, tar can also be used to move 
hierarchies with the command: 

cd fromdir; tar cf - . I (cd todir; tar xf -) 

b Causes tar to use the next argument as the blocking factor 

for archive records. The default is 1, the maximum is 20. 
This option should only be used with raw magnetic tape 
archives (see f above). The block size is determined 
automatically when reading tapes (key letters x and t). 

F Causes tar to use the next argument as the name of a file 

from which succeeding arguments are taken. 

1 Tells tar to display an error message if it cannot resolve all 

of the links to the files being backed up. If 1 is not specified, 
no error messages are displayed. 

m Tells tar to not restore the modification times. The 

modification time of the file is the time of extraction. 

k Causes tar to use the next argument as the size of an archive 

volume in kilobytes. The minimum value allowed is 250. 
Very large files are split into "extents" across volumes. 
When restoring from a multivolume archive, tar only 
prompts for a new volume if a split file has been partially 
restored. 
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To override the value of k in the default file, specify k as 
on the command line. 

e Prevents files from being split across volumes (tapes or 

floppy disks). If there is not enough room on the present 
volume for a given file, tar prompts for a new volume. This 
is only valid when the k option is also specified on the com- 
mand line. 

n Indicates the archive device^ is not a magnetic tape. The k 

option implies this. Listing and extracting the contents of an 
archive are sped because tar can seek over files it wishes to 
skip. Sizes are printed in kilobytes instead of tape blocks. 

p Indicates that files are extracted using their original permis- 

sions. It is possible that a non-super-user may be unable to 
extract files because of the permissions associated with the 
files or directories being extracted. 

A Suppresses absolute filenames. Any leading "/"characters 

are removed from filenames. During extraction arguments 
given should match the relative (rather than the absolute) 
pathnames. With the c, r, u options the A options can be 
used to inhibit putting leading slashes in the archive 
headers. 

tar reads /etc/default/tar to obtain default values for the device, 
blocking factor, volume size, and the device type (tape or non-tape). 
If no numeric key is specified on the command, tar looks for a line in 
the default file beginning with the string archive=. Following this 
pattern are 4 blank separated strings indicating the values for the dev- 
ice, blocking factor, volume size and device type, in that order. A 
volume size of '0' indicates infinite volume length, (the previous 
default value of volume) and is suitable for magnetic tape media. For 
example, the following is the default device entry from 
/etc/default/tar : 

archive=/dev/fd096dsl5 10 1200 n 

The n in the last field, means that this device is not a tape. Use y for 
tape devices. Any default value may be overridden on the command 
line. The numeric keys (0-7) select the line from the default value 
beginning with archive#-, where # is the numeric key. When the f 
key letter is specified on the command line, the entry "archive/-" is 
used. In this case, the default file entry must still contain 4 strings, but 
the first entry (specifying the device) is not significant. The default 
file /etc/default/tar need not exist if a device is specified on the com- 
mand line. 
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Notes 

A critical consideration when creating a tar volume involves the use 
of absolute or relative pathnames. Consider the following tar com- 
mand examples, as executed from the directory /u/tarzan: 
tar cv /u/tarzan/mejane 

tar cv mejane The first command creates a tar volume with the abso- 
lute pathname: /u/tarzan/mejane. The second yields a tar volume with 
a relative pathname: ./mejane. (The ./ is implicit and shown here as an 
example, ./ should not be specified when retrieving the file from the 
archive.) When restored, the first example results in the file mejane 
being written to the directory /u/tarzan (if it exists and you have write 
permission) no matter what your working directory. The second 
example simple writes the file mejane to your present working direc- 
tory. 

Absolute pathnames specify the location of a file in relation to the root 
directory (/); relative pathnames are relative to the current directory. 
This must be taken into account when making a tar tape or disk. 
Backup volumes use absolute pathnames so that they can be restored 
to the proper directory. Use relative pathnames when creating a tar 
volume where absolute pathnames are unnecessary. 



Examples 

If the name of a floppy disk device is /dev/fdl, then a tar format file 
can be created on this device by entering: 

assign /dev/fd 

tar cvfk /dev/fdl 360 files 

where files are the names of files you want archived and 360 is the 
capacity of the floppy disk in kilobytes. Note that arguments to key 
letters are given in the same order as the key letters themselves, thus 
the fk key letters have corresponding arguments /dev/fdl and 360. 
Note that if a file is a directory, the contents of the directory are recur- 
sively archived. To display a listing of the archive, enter: 

tar tvf /dev/fdl 

At some later time you will likely want to extract the files from the 
archive floppy. You can do this by entering: 

tar xvf /dev/fdl 

The above command extracts all files from the archive, using the exact 
same pathnames as used when the archive was created. Because of 
this behavior, it is normally best to save archive files with relative 
pathnames rather than absolute ones, since directory permissions may 
not let you read the files into the absolute directories specified. (See 
the A flag under Options .) 
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In the above examples, the v verbose option is used simply to confirm 
the reading or writing of archive files on the screen. Also, a normal file 
could be substituted for the floppy device /dev/fdl shown in the exam- 
ples. 



Files 

/etc/default/tar Default devices, blocking and 

volume sizes, device type 

/tmp/tar* 



Diagnostics 

Displays an error message about bad key characters and archive 
read/write errors. 

Displays an error message if not enough memory is available to hold 
the link tables. 

Notes 

There is no way to ask for the nth occurrence of a file. 

The u option can be slow. 

The limit on filename length is 100 characters. 

When archiving a directory that contains subdirectories, tar will only 
access those subdirectories that are within 17 levels of nesting. Sub- 
directories at higher levels will be ignored after tar displays an error 
message. 

When using tar with a raw device, specify the block size with the b 
option as a multiple of IK. For example, to use a 9K block size, enter: 

tar cvfb /dev/rfdO 18 file 

Do not enter: 

tar xfF - - 

This would imply taking two things from the standard input at the 
same time. 

Use error-free floppy disks for best results with tar. 
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Name 

tee - Creates a tee in a pipe. 

Syntax 

tee [ -i ] [ -a ] [ -u ] [ file ] ... 

Description 

tee transcribes the standard input to the standard output and makes 
copies in the files . The -i option ignores interrupts; the -a option 
causes the output to be appended to the files rather than overwriting 
them. The -u option causes the output to be unbuffered. 

Examples 

The following example illustrates the creation of temporary files at 
each stage in a pipeline: 

grep ABC I tee ABC.grep I sort I tee ABC.sort I more 

This example shows how to tee output to the terminal screen: 

grep ABC I tee /dev/ttyxx I sort I uniq >final.file 
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Name 

test - Tests conditions. 



TEST (C) 



Syntax 
test expr 
[ expr ] 

Description 

test evaluates the expression expr, and if its value is true, returns a 
zero (true) exit status; otherwise, test returns a nonzero exit status if 
there are no arguments. The following primitives are used to con- 
struct expr: 



-rfile True if file exists and is readable. 

-vtfile True if file exists and is writable. 

-xfile True if file exists and is executable. 

-ffile True if file exists and is a regular file. 

-A file True if file exists and is a directory. 

-cfile True if file exists and is a character special file. 

-bfile True if file exists and is a block special file. 

-ufile True if file exists and its set-user-ID bit is set. 

-gfile True if file exists and its set-group-ID bit is set. 

-kfile True if file exists and its sticky bit is set. 

-sfile True if file exists and has a size greater than zero. 

-t [fildes] True if the open file whose file descriptor number is 
fildes ( 1 by default) is associated with a terminal dev- 
ice. 

-z si True if the length of string si is zero, 

-n si True if the length of string si is nonzero. 

si = s2 True if strings si and s2 are identical. 
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sl\=s2 True if strings si and s2 are not identical. 

si True if si is not the null string. 

nl -eq n2 True if the integers nl and n2 are algebraically equal. 



Any of the comparisons -ne, -gt, -ge, -It, and -le may 
be used in place of -eq. 



These primaries may be combined with the following operators: 



! Unary negation operator 

-a Binary and operator 

-o Binary or operator (-a has higher precedence than 

-o) 

( expr ) Parentheses for grouping 



Notice that all the operators and flags are separate arguments to test. 
Notice also, that parentheses are meaningful to the shell and, there- 
fore, must be escaped. 

See Also 

find(C), sh(C) 

Warning 

In the second form of the command (i.e., the one that uses [], rather 
than the word test), the square brackets must be delimited by blanks. 
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Name 

tic - Terminfo compiler. 



Syntax 

tic [-v [n] [-p permlist] ] file ... 



Description 

tic translates terminfo files from the source format into the compiled 
format. The results are placed in the directory /usr/lib/terminfo. 

The -v (verbose) option causes tic to output trace information showing 
its progress. If the optional digit n is appended, the level of verbosity 
can be increased. 

The -p option directs tic to create a permissions file permlist for use 
with fixperm{ ADM) . 

tic compiles all terminfo descriptions in the given files. When a use= 
field is discovered, tic first searches the current file and then the mas- 
ter file ./terminfo.src. 

If the environment variable TERMINFO is set, the results are placed 
there instead of /usr/lib/terminfo. 

Some limitations: the total size of a description cannot exceed 4096 
bytes; the name field cannot exceed 128 bytes. 



Files 

/usr/lib/terminfo/*/* -Compiled terminal capability database. 



See Also 

terminfo(M), terminfo(S), terminfo(F), tid(C) 



Notes 

Use of the -p option is not recommended. The functionality may 
change in future versions of XENIX. 
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Name 

tid - Terminfo decompiler. 

Syntax 

tid [term] 

Description 

tid decompiles the description of terminal term originally compiled by 
tic(C). If term is not specified, the setting of the TERM environment 
variable is used. 

Files 

/usr/lib/terminfo/*/* - Compiled terminal descriptions. 

See Also 

tic(C), terminfo(F), terminfo(M). 

Notes 

The output of tid is not acceptable input to tic . 
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Name 

touch - Updates access and modification times of a file. 



Syntax 

touch [ -amc ] [ mmddhhmm[yy] ] files 



Description 

touch causes the access and modification times of each argument to 
be updated. If no time is specified (see date(C)) the current time is 
used. The first mm refers to the month, dd refers to the day, hh refers 
to the hour, the second mm refers to the minute, and yy refers to the 
year. The -a and -m options cause touch to update only the access or 
modification times respectively (default is -am). The -c option 
silently prevents touch from creating the file if it did not previously 
exist. 

The return code from touch is the number of files for which the times 
could not be successfully modified (including files that did not exist 
and were not created). 



See Also 

date(C), utime(S) 
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Name 

tput - Queries the terminfo database. 



Syntax 

tput [ -Ttype ] attribute 



Description 

The command tput uses the terminfo database to make the values of 
terminal-dependent attributes available to the shell, tput outputs a 
string if the terminal attribute is of type string, or an integer if the 
attribute is of type integer. If the attribute is of type Boolean, tput 
simply sets the exit code (0 for true if the terminal has the capability, 
1 for false if it does not) and produces no output. 

The -T flag indicates the type of the terminal. Normally this option is 
unnecessary, as the default is taken from the environment variable 
TERM. 

attribute is the terminal capability name from the terminfo database. 



Examples 
tput clear 

tput cols 

tput -T450 cols 



Echo clear-screen sequence for the current ter- 
minal. 

Print the number of columns for the current ter- 
minal. 

Print the number of columns for the 450 termi- 
nal. 



bold='tput smso' 

offbold='tput rmso' Set the shell variables "bold" to begin stan- 
dout mode sequence and "offbold" to end 
standout mode sequence for the current termi- 
nal. This might be followed by a prompt, such 
as: 



echo "${bold}Name: ${offbold}V 
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TPUT{C) 



tput he 



Set exit code to indicate if the current terminal 
is a hardcopy terminal. 



Files 



/usr/lib/terminfo/*/* -Compiled terminal capability database. 
See Also 

terminfo(M), terminfo(S), tic(C), stty(C) 



If the attribute is of type boolean, a value of is returned for TRUE 
and a value of 1 for FALSE. 

If the attribute is of type string or integer, a value of is returned upon 
successful completion. Any other value returned indicates an error. 
For example, the specification of a bad attribute (any capability name 
that is not found in the terminfo database) produces an error. 



Notes 
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Name 

tr - Translates characters. 



Syntax 

tr [ -cds ] [ string 1 [ string2 ] ] 



Description 

tr copies the standard input to the standard output with substitution or 
deletion of selected characters. Input characters found in stringl are 
mapped into the corresponding characters of string2 . Any combina- 
tion of the options -cds may be used: 

-c Complements the set of characters in stringl with respect to 

the universe of characters whose ASCII codes are 001 
through 377 octal 

-d Deletes all input characters in stringl 

-s Squeezes all strings of repeated output characters that are in 

stringl to single characters 

The following abbreviation conventions may be used to introduce 
ranges of characters or repeated characters into the strings: 

[a-z] Stands for the string of characters whose ASCII codes run 
from character a to character z, inclusive. 

[a*n] Stands for n repetitions of a. If the first digit of n is 0, n is 
considered octal; otherwise, n is taken to be decimal. A 
zero or missing n is taken to be huge; this facility is useful 
for padding stringl . 

The escape character \ may be used as in the shell to remove special 
meaning from any character in a string. In addition, \ followed by 1, 2, 
or 3 octal digits, stands for the character whose ASCII code is given by 
those digits. 
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The following example creates a list of all the words in filel, one per 
line in file2, where a word is taken to be a maximal string of alphabet - 
ics. The strings are quoted to protect the special characters from 
interpretation by the shell; 012 is the ASCII code for newline: 

tr -cs "[A-Z][a-z]" "{\012*]" <filel >file2 

See Also 

ed(C), sh(C), ascii(M) 
Notes 

Won't handle ASCII NUL in stringl or string! ; always deletes NUL 
from input. 
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Name 

translate - translates files from one format to another 
Syntax 

translate option [ infile ] [ outfile ] 



Description 

translate translates files according to the options specified. Transla- 
tion is done according to the options defined below. 

format is assumed to be a file in the directory 
/usr/lib/mapchan/translate if a full pathname is not provided. 

translate uses standard input and standard output unless otherwise 
specified via the optional filename arguments. 



Options 

-ea From EBCDIC to ASCII. 

-ae From ASCII to EBCDIC. 

-fe format From a user defined format to EBCDIC format. 

-fa format From a user defined format to ASCII format. 

-ef format From EBCDIC format to a user defined format. 

-af format From ASCII format to a user defined format. 

-bm From binary/object code to mailable ASCII 

uuencode format. 

-mb From mailable ASCII uuencode format to 

original binary. 



Files 

/usr/lib/mapchan/translate/* 
See Also 

uuencode(C), dd(C), mapchan(M), sysadmsh(ADM) 
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Notes 

The -bm and -mb options are, for example, used to translate execut- 
able object code format to ASCII for transfer across communications 
networks. 

The syntax for the user defined format file is the same as the syntax 
for the mapping files for mapchanQA) and trchan. 

Use dd to convert character and file formats (especially tapes) to the 
format specified. Example: 

dd if=/dev/rmtO of=outfile ibs=800 cbs=80 conv=ascii,lcase 

This command reads an EBCDIC tape, blocked ten 80-byte EBCDIC 
card images per record, into the ASCII file outfile. For more informa- 
tion on conversion options, refer to dd(C) in the XENIX Reference. 
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Name 

true - Returns with a zero exit value. 

Syntax 
true 

Description 

true does nothing except return with a zero exit value, false (C), true's 
counterpart, does nothing except return with a nonzero exit value. 
true is typically used in shell procedures such as: 



while true 
do 



command 



done 



See Also 



sh(C), false (C) 



Diagnostics 



true has exit status zero. 
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Name 

tset - Sets terminal modes. 



Syntax 

tset [ - ] [ -hrsuIQS ] [ -e[c] ] [ -E[c] ] [ -k[c] ] 
[ -m [ident] [test baudrate ]:type ] [ type ] 



Description 

tset causes terminal dependent processing such as setting erase and 
kill characters, setting or resetting delays, and the like. It is driven by 
the /etc/ttytype and /etc/termcap files. 

The type of terminal is specified by the type argument. The type may 
be any type given in /etc/termcap. If type is not specified, the termi- 
nal type is the value of the environment variable TERM, unless the -h 
flag is set or any -m argument is given. In this case, the type is read 
from /etc/ttytype (the port name to terminal type database). The port 
name is determined by a ttyname (S) call on the diagnostic output. If 
the port is not found in /etc/ttytype the terminal type is set to 
unknown. 

Ports for which the terminal type is indeterminate are identified in 
/etc/ttytype as dialup, plugboard, etc. The user can specify how these 
identifiers should map to an actual terminal type. The mapping flag, 
-m, is followed by the appropriate identifier (a four-character or 
longer substring is adequate), an optional test for baud rate, and the 
terminal type to be used if the mapping conditions are satisfied. If 
more than one mapping is specified, the first correct mapping prevails. 
A missing identifier matches all identifiers. Baud rates are specified 
as with stty(C), and are compared with the speed of the diagnostic out- 
put. The test may be any combination of: >, =, <, @, and !. (Note: <5) 
is a synonym for = and ! inverts the sense of the test. Remember that 
escape characters are meaningful to the shell.) 

If the type as determined above begins with a question mark, the user 
is asked if he really wants that type. A null response means to use that 
type; otherwise, another type can be entered which will be used 
instead. (The question mark must be escaped to prevent filename 
expansion by the shell.) 

tset is most useful when included in the .login (for csh(C)) or .profile 
(for sh(C)) file executed automatically at login, with -m mapping used 
to specify the terminal type you most frequently dial in on. 
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Options 

-e This option sets the erase character to the named character, c, with 
c defaulting to Ctrl-H. 

-E This flag is identical to -e except that it only operates on terminals 
that can backspace. 

-k This option sets the kill character to the named character, c, with c 
defaulting to Ctrl-U. In all of these flags, ""X" where X is any 
character is equivalent to Ctrl-X . 

- This option prints the terminal type on the standard output; this can 
be used to get the terminal type by entering: 

set termtype = N tset - v 

If no other options are given, tset operates in ' 'fast mode' ' and only 
outputs the terminal type, bypassing all other processing. 

-h Forces tset to search /etc/ttytype for information and to overlook 
the environment variable, TERM. 

-s This option outputs "setenv" commands (if your default shell is 
csh(C) or "export" and assignment commands (if your default 
shell is sh(C)); 

For the -s option with the Bourne shell, enter: 

tset -s ... >/tmp/tset$$ 

/tmp/tset$$ 

rm/tmp/tset$$ 



-S This option only outputs the strings to be placed in the environ- 
ment variables. 

If you are using csh, enter: 
set noglob 

set term=('tset -S ....') 
setenv TERM $term[l] 
setenv TERMCAP "$term[2]" 
unset term 
unset noglob 

-r This option displays the terminal type on the diagnostic output. 

-Q This option suppresses displaying the "Erase set to" and "Kill set 
to" messages. 

-I This option suppresses outputting the terminal initialization 
strings. 
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■m 



This option is the mapping flag. It is used to specify the terminal 
type you most frequently use. It is followed by the appropriate 
identifier for your terminal, listed in /etc/ttytype . When you log 
on the system, it sets the terminal type to ident unless you specify 
otherwise. 



Sets the terminal type to gt42. 

tset -mdialup\>300:adm3a -mdialup:dw2 -Qr -e# 

If the entry in /etc/ttytype corresponding to the login port is 
"dialup", and the port speed is greater than 300 baud, set the ter- 
minal type to adm3a. If the /etc/ttytype entry is "dialup" and the 
port speed is less than or equal to 300 baud, set the terminal type to 
dw2. Set the erase character to "#", and display the terminal type 
(but not the erase character) on standard error. 

tset -m dial:ti733 -m plug:\?hp2621 -m unknown:\? -e -k~U 

If the /etc/ttytype entry begins with "dial", the terminal type 
becomes ti733. If the entry begins with "plug", tset prompts with: 

TERM = (hp2621) 

Enter the correct terminal type if it is different than that shown. If 
the entry is ' 'unknown' ', tset prompts with: 

TERM = (unknown) 

In any case erase is set to the terminal's backspace character, and 
the terminal type is displayed on standard error and the kill charac- 
ter is set to Ctrl-U. 



Examples 



tset gt42 



Files 



/etc/ttytype 



Port name to terminal type map database 



/etc/termcap 



Terminal capability database 
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See Also 

tty(M), termcap(M), stty(C) 



Credit 



This utility was developed at the University of California at Berkeley 
and is used with permission. 



May 16, 1988 



Page 4 



77Y(C) 



77T(C) 



Name 

tty - Gets the terminal's name. 

Syntax 
tty [-s] 

Description 

The tty command prints the pathname of the user's terminal on the 
standard output. The -s option inhibits printing, allowing you to test 
just the exit code. 

Exit Codes 

if the standard input is a terminal, 1 otherwise. 
Diagnostics 

not a tty If the standard input is not a terminal and -s is not 
specified 
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Name 

umask - Sets file-creation mode mask. 



Syntax 

umask [ 000 ] 



Description 

The user file-creation mode mask is set to 000 . The three octal digits 
refer to read/write/execute permissions for owner, group, and others, 
respectively. Only the low-order 9 bits of cmask and the file mode 
creation mask are used. The value of each specified digit is "sub- 
tracted" from the corresponding "digit" specified by the system for 
the creation of any file (see umask(S) or creat(S)). This is actually a 
binary masking operation, and thus the name "umask". In general, 
binary ones remove a given permission, and zeros have no effect at 
all. For example, umask 022 removes group and others write permis- 
sion (files normally created with mode 777 become mode 755 ; files 
created with mode 666 become mode 644). 

If 000 is omitted, the current value of the mask is printed. 

umask is recognized and executed by the shell. By default, login 
shells have a umask of 022. 



See Also 

chmod(C), sh(C), chmod(S), creat(S), umask(S) 



May 16, 1988 



Page 1 



UNAME (C) 



UNAME (C) 



Name 

uname - Prints the name of the current XENIX system. 

Syntax 

uname [ -snrmvdupa ] 

Description 

uname prints the current system name of the XENIX system on the 
standard output file. It is primarily used to determine which system 
you are using. The options cause selected information returned by 
uname (S) to be printed: 

-s Prints the system name (default). 

-n Prints the nodename (the nodename may be a name that the sys- 
tem is known by to a communications network). 

-r Prints the operating system release. 

-m Manufacturer prints original supplier (number) of XENIX sys- 
tem. 

-v Prints the operating system version. 

-d Distributor prints OEM (number) for the system. 

-u Prints user serial number. 

-p Prints processor of the machine. 

-a Prints all the above information. 

See Also 

uname(S) 
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Name 

uniq - Reports repeated lines in a file. 



Syntax 

uniq [ -udc [ +n ] [ -n ] ] [ input [ output ] ] 



Description 

uniq reads the input file and compares adjacent lines. In the normal 
case, the second and succeeding copies of repeated lines are removed; 
the remainder is written on the output file. Input and output should 
always be different. Note that repeated lines must be adjacent in order 
to be found; see sortiC). If the -u flag is used, just the lines that are 
not repeated in the original file are output. The -d option specifies 
that one copy of just the repeated lines is to be written. The normal 
mode output is the union of the -u and -d mode outputs. 

The -c option supersedes -u and -d and generates an output report in 
default style but with each line preceded by a count of the number of 
times it occurred. 

The n arguments specify skipping an initial portion of each line in the 
comparison: 

-n The first n fields together with any blanks before each are 

ignored. A field is defined as a string of nonspace, nontab 
characters separated by tabs and spaces from its neighbors. 

+n The first n characters are ignored. Fields are skipped before 
characters. 

See Also 

comm(C), sort(C) 
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Name 

units - Converts units. 



Syntax 
units 



Description 

units converts quantities expressed in various standard scales to their 
equivalents in other scales. It works interactively in this fashion: 

You have: inch 
You want: cm 

* 2.540000e+00 
/ 3.937008e-01 

A quantity is specified as a multiplicative combination of units 
optionally preceded by a numeric multiplier. Powers are indicated by 
suffixed positive integers, division is shown by the usual sign: 

You have: 15 lbs force/in2 
You want: atm 

* 1.020689e+00 

/9.797299e-01 

units only does multiplicative scale changes; thus it can convert Kel- 
vin to Rankine, but not Centigrade to Fahrenheit. Most familiar units, 
abbreviations, and metric prefixes are recognized, as well as the fol- 
lowing: 

pi Ratio of circumference to diameter 

c Speed of light 

e Charge on an electron 

g Acceleration of gravity 

force Same as g 

mole 

Avogadro's number 

water 

Pressure head per unit height of water 
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au Astronomical unit 

Pound is not recognized as a unit of mass; lb is. Compound names are 
run together, (e.g. lightyear). British units that differ from their US 
counterparts are prefixed with "br". For a complete list of units, 
enter: 

cat /usr/lib/unittab 



Files 

/usr/lib/unittab 
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Name 

uptime - Displays information about system activity. 



Syntax 
uptime 



Description 

uptime prints the current time of day, the length of time the system has 
been up, and the number of users logged onto the system. On systems 
that maintain the necessary data, load averages are also shown. Load 
averages are the number of processes in the run queue averaged over 
1,5, and 15 minutes. All of this information is also contained in the 
first line of the w(C) command. 



See Also 

w(C) 
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Name 

usemouse - Maps mouse input to keystrokes for use with non-mouse 
based programs. 



Syntax 

usemouse [ -f conffile ] [ -t type ] [ -h horiz_sens ] [ -v vert_sens ] [ 
-c cmd ] [ -b ] parameters 



Description 

This utility allows you to use a mouse with any program that would 
otherwise accept only keyboard input. 

For example, you can use a mouse with v/(C) to move the cursor 
around the screen and generate your most commonly used vi com- 
mands. The usemouse(C) command translates mouse input into 
specific keystrokes required by a program. You can use any of several 
predefined mouse keystroke sets (called maps) that correspond to dif- 
ferent popular programs. You can also define your own maps with 
keystrokes that match different mouse movements and mouse buttons. 



Options 

The options are: 



-f conffile 

The -f flag may be used to select an alternate configuration file. 
The alternate configuration file, conffile, should use the format of 
/etc/default/usemouse and be entered as an absolute pathname on 
the command line. For example: 

usemouse -f /u/daniel/mouseconf 

is the correct form to specify an alternate configuration file. The -f 
and -t flags are mutually exclusive. 

-t type 

The -t flag may be used to select a predefined configuration file. 
type can be the name of any file in /usr/lib/mouse, such as vi, 
rogue, or any others the system administrator chooses to place 
there. These files are identical in format to /etc/default/usemouse. 

-h horiz_sens 

Defines the horizontal sensitivity. Horizontal mouse movements 
smaller than this threshold are ignored. Mouse movements that are 
multiples of this value generate multiple strings. The sensitivity 
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defaults to 5 units. The minimum value is 1 unit, and the max- 
imum is 100 units. The lower the value, the more sensitive your 
mouse is to motion. Note that setting a high value may cause your 
mouse to behave as though it is not functioning, due to the large 
motion required to generate a signal. 

-v vert_sens 

Defines the vertical sensitivity. Vertical mouse movements 
smaller than this threshold are ignored. Mouse movements that are 
multiples of this value generate multiple strings. The sensitivity 
defaults to 5 units. The minimum value is 1 unit, and the max- 
imum is 100 units. The lower the value, the more sensitive your 
mouse is to motion. Note that setting a high value may cause your 
mouse to behave as though it is not functioning, due to the large 
motion required to generate a signal. 



This option selects a command for usemouse to run. This defaults 
to the shell specified in the SHELL environment variable. If 
SHELL is unspecified, /bin/sh is used. Note that the command 
given with this flag can contain blank spaces if the entire command 
is placed within double quotes. For example: 

usemouse -c "vi /etc/termcap " 



-b Supresses bell (~G) for the duration of mouse usage. Useful with 
v/(C). 



parameters 

These are name=value pairs indicating what ASCII string to insert 
into the tty input stream, when the given event is received. Valid 
parameters include: 



-c cmd 



is valid. 



Ybu=string 
ibd=string 



String to generate on right button up 
String to generate on right button down 
String to generate on middle button up 
String to generate on middle button down 
String to generate on left button up 
String to generate on left button down 
String to generate on mouse right 
String to generate on mouse left 
String to generate on mouse up 
String to generate on mouse down 
String to generate on mouse up-left 
String to generate on mouse up-right 
String to generate on mouse down-left 



mbu=string 
mbd=string 



\b\x=string 
Vod=string 
vt=string 
\t=string 
up=string 
dn=string 
u\=string 
m=string 
dr=string 
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dl=string 



String to generate on mouse down-right 
Sensitivity to horizontal motion 
Sensitivity to vertical motion 
Whether to remove "G characters 



h$>em=num 
vsens-num 
bells=yes/no 



Parameters may be specified in any order. They may contain octal 
escapes. They may be quoted with single or double quotes if they con- 
tain blank spaces. Any parameters may be omitted and their value, if 
any, is taken from the configuration file. 



The usemouse(C) Command 

To start using the mouse with a text program, enter the command: 
usemouse 

This command sets the mouse for use with the default map, which is 
found in /etc/default/mouse. Alternate map files can be found in the 
directory /usr/lib/mouse. You can create your own alternate map files 
and place them in this directory or in your own custom map file direc- 
tory. The default map file has the following values: 



Mouse 


Keystroke 


Left Button 


vi top of file (1G) command 


Middle Button 


vi delete character (x) command 


Right Button 


vi bottom of file (G) command 


Up 


Up Arrow Key 


Down 


Down Arrow Key 


Left 


Left Arrow Key 


Right 


Right Arrow Key 


Up and Left 


not defined 


Up and Right 


not defined 


Down and Left 


not defined 


Down and Right 


not defined 


Bells 


no 



Invoking the usemouse command without specifying any options 
makes the mouse ready for use with a wide variety of programs or 
applications. Invoking usemouse with no options causes the mouse to 
use the default keystroke map. Invoking the mouse in this way creates 
a new command shell. You can continue to use the mouse for the dura- 
tion of the shell. To terminate usemouse, simply enter Ctrl-D. 

You can also invoke usemouse for the duration of a specific command: 

usemouse -c command 

This puts you in the program specified by command using the mouse. 
When you leave the program, mouse input is terminated. 
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Using the Mouse with Specific Programs 

You can use any of several predefined maps that are set up specifically 
for use with different programs. (These maps are found in 
/usr/lib/mouse.) For example: 

usemouse -t vi 

This invokes the vz'-specific map, which includes mapping the tradi- 
tional h-j-k-1 direction keys to the mouse movements. The terminal 
bell is automatically silenced by the vi map entry bells=no. This is 
done to prevent the bell being activated continuously when the user 
generates a spurious command with the mouse. (There is also a -b 
option that can be used on the usemouse command line to do the same 
thing.) 

You can combine a command with a selected map file by putting both 
on the command line. For example: 

usemouse -t vi -c vi filename 

This invokes the vi map along with the command; when you quit out 
of v/ the mouse disengages. 



Setting Up Abbreviated (Aliased) Mouse Commands 

If you plan to use the mouse frequently, you can substitute short, easy 
to use commands that will call up the longer command lines. This is 
known as command aliasing. For more information on command alias- 
ing, consult the section "Using Aliases" in the "C-Shell" chapter of 
the XENIX User's Guide. 

Specifying Map Keystrokes on the Command Line 

You can also specify the characters to be generated by mouse motions 
on the usemouse command line. You can specify button actions or 
motion actions to supplement or replace a definition from a map file. 
For example, assume you want to use the default usemouse file, but 
you want to redefine the middle mouse button mbd (middle button 
down) as the vi "i" (insert) instead of the "x" (delete character) com- 
mand. The following command line does this: 

usemouse -c vi mbd=i 

The mouse operations are defined by a series of acronyms that are the 
same as used in the actual map file: 
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Parameter Mouse Operation 



Default 



rbu 

rbd 

mbu 

mbd 

lbu 

lbd 

ul 



dr 

dl 

rt 

It 

up 

dn 



vsens 



hsens 



ur 



right button up 
right button down 
middle button up 
middle button down 
left button up 
left button down 
mouse up-left 
mouse up-right 
mouse down-left 
mouse down-right 
mouse right 
mouse left 
mouse up 
mouse down 
horiz. sensitivity 
vert, sensitivity 



not used 
G 

\033[A\033[C 

\033[A\033[D 

\033[B\033[C 

\033[B\033[D 

\033[C 

\033[D 

\033[A 

\033[B 

5 

5 



not used 
1G 

not used 



x 



Creating Customized Maps 

You can create your own personal map files for use with the mouse. 
The easiest way to do this is to copy the default map in 
/etc/default/usemouse and edit it. You can use quoted strings or the 
octal sequences found in the ascii(M) page. The mouse 
direction/button parameters are defined in the usemouse table above. 
For example, after placing a customized file, mine, in your home 
directory, you would invoke the following command to use it with the 
program prog: 

usemouse -f mine -c prog 

How usemouse Works 

usemouse merges data from a mouse into the input stream of a tty. The 
mouse data is translated to arrow keys or any other arbitrary ASCII 
strings. Mouse movements up, down, left right, up-left, up-right, 
down-left, and down-right, as well as individual up and down button 
transitions, are programmable. This permits the mouse to be used 
with programs that are not designed to accept mouse input. 

By default,the usemouse utility gets value configurations from the file 
I etcl default! usemouse . 

After running the utility, provided a mouse is available, the user will 
be running a command with mouse motions and button events 
translated to ASCII strings and merged into their tty input stream. By 
default, the command is a shell. 
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Files 

Directory for mouse-related special device files. 
Bus mouse device files, 
vpix -mouse device files. 
Microsoft serial mouse device files. 
Logitech serial mouse device files. 
Mousesys serial mouse device files. 
Special pseudo-tty files for mouse input. 
Special pseudo-tty files for mouse input. 
Default map file for mouse-generated characters. 
File containing device information for mice. 
File listing ttys eligible to use mice. 
Alternate map files for mice. 



See Also 

mouse(HW) 



/dev/mouse 
/dev/mouse/bus [0- 1 ] 
/dev/mouse/vpix [0- 1 ] 
/dev/mouse/microsoft_ser 
/dev/mouse/logitech_ser 
/dev/mouse/mousesys_ser 
/de v/mouse/ttyp [0-7] 
/dev/mouse/ptyp [0-7] 
/etc/default/usemouse 
/usr/lib/event/devices 
/usr/lib/event/ttys 
/usr/lib/mouse/* 
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Name 

uucp, uulog, uuname - UNIX-to-UNIX system copy 



Syntax 

uucp [ options ] source-files destination-file 
uulog [ options ] -s system 
uulog [ options ] system 
uulog [ options ] -f system 
uuname [ -1 ] [ -c ] 



Description 
uucp 

uucp copies files named by the source-file arguments to the 
destination-file argument. A file name may be a path name on your 
machine, or may have the form: 

system-name !path-name 

where system-name is taken from a list of system names that uucp 
knows about. The system-name may also be a list of names such as 

system-name ! system-name ! . . . ! system-name !path-name 

in which case an attempt is made to send the file via the specified 
route, to the destination. See Warnings and Notes below for restric- 
tions. Care should be taken to ensure that intermediate nodes in the 
route are willing to forward information (see Warnings below for res- 
trictions). 

The shell metacharacters ?, * and [ . . . ] appearing in path-name will 
be expanded on the appropriate system. 

Path names may be one of: 

(1) a full path name; 

(2) a path name preceded by 'user where user is a login name 
on the specified system and is replaced by that user's login 
directory; 

(3) a path name preceded by '/destination where destination is 
appended to /usr/spool/uucppublic; (NOTE: This destina- 
tion will be treated as a file name unless more than one file is 
being transferred by this request or the destination is already 
a directory. To ensure that it is a directory, follow the desti- 
nation with a '/'• For example ~/dan/ as the destination will 
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make the directory /usr/spool/uucppublic/dan if it does not 
exist and put the requested file(s) in that directory). 

(4) anything else is prefixed by the current directory. 

If the result is an erroneous path name for the remote system the copy 
will fail. If the destination-file is a directory, the last part of the 
source-file name is used. 

uucp preserves execute permissions across the transmission and gives 
0666 read and write permissions (see chmod(2)). 

The following options are interpreted by uucp : 

-c Do not copy local file to the spool directory for transfer to 

the remote machine (default). 

-C Force the copy of local files to the spool directory for 

transfer. 

-d Make all necessary directories for the file copy (default). 

-f Do not make intermediate directories for the file copy. 

-ggrade Grade is a single letter/number; lower ascii sequence 
characters will cause the job to be transmitted earlier dur- 
ing a particular conversation. 

-j Output the job identification ASCII string on the standard 

output. This job identification can be used by uustat to 
obtain the status or terminate a job. 

-m Send mail to the requester when the copy is completed. 

-nuser Notify user on the remote system that a file was sent. 

-r Do not start the file transfer, just queue the job. 

-sfile Report status of the transfer to file. Note that the file must 
be a full path name. 

-xdebugjevel 

Produce debugging output on standard output. The 
debug Jevel is a number between and 9; higher numbers 
give more detailed information. 



uulog 

uulog queries a log file of uucp or uuxqt transactions in a file 
/usr/spool/uucp/Xog/uucicoAsystem, or 
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/usr/spool/uucp/.Log/uuxqt/yystem. 

The options cause uulog to print logging information: 

-ssys Print information about file transfer work involving sys- 
tem sys. 

-isystem Does a "tail -f" of the file transfer log for system. (You 
must press DELETE or BREAK to exit this function.) 
Other options used in conjunction with the above: 

-x Look in the uuxqt log file for the given system, instead of 

the uucico log file (default). 

-number Indicates that a "tail" command of number lines should 
be executed. 



uuname 

uuname lists the names of systems known to uucp. The -c option 
returns the names of systems known to cu. (The two lists are the 
same, unless your machine is using different Systems files for cu and 
uucp. See the Sysfiles file.) The -1 option returns the local system 
name. 



Files 

/usr/spool/uucp spool directories 
/usr/spool/uucppublic/*public directory for receiving and 

sending (/usr/spool/uucppublic) 
/usr/lib/uucp/* other data and program files 



See Also 

mail(C), uustat(C), uux(C), uuxqt(C). 
chmod(S) in the XENIX Programmer' s Reference. 



Warnings 

The domain of remotely accessible files can (and for obvious security 
reasons, usually should) be severely restricted. You will very likely 
not be able to fetch files by path name; ask a responsible person on the 
remote system to send them to you. For the same reasons you will 
probably not be able to send files to arbitrary path names. As distri- 
buted, the remotely accessible files are those whose names begin 
/usr/spool/uucppublic (equivalent to "/). 
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All files received by uucp will be owned by uucp . 
The -m option will only work sending files or receiving a single file. 
Receiving multiple files specified by special shell characters ? * [ . . . ] 
will not activate the -m option. 

The forwarding of files through other systems may not be compatible 
with the previous version of uucp. If forwarding is used, all systems in 
the route must have the same version of uucp. 



Notes 

Protected files and files that are in protected directories that are owned 
by the requester can be sent by uucp. However, if the requester is 
root, and the directory is not searchable by "other" or the file is not 
readable by "other," the request will fail. 
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Name 

uuencode, uudecode - encode/decode a binary file for transmission via 
mail 



Syntax 

uuencode [ source ] remotedest I mail sysl!sys2L! decode 
uudecode [ file ] 



Description 

uuencode and uudecode are used to send a binary file via uucp (or 
other) mail. This combination can be used over indirect mail links. 

uuencode takes the named source file (default standard input) and pro- 
duces an encoded version on the standard output. The encoding uses 
only printing ASCII characters, and includes the mode of the file and 
the remotedest for recreation on the remote system. 

uudecode reads an encoded file, strips off any leading and trailing 
lines added by mailers, and recreates the original file with the speci- 
fied mode and name. 

The intent is that all mail to the user "decode" should be filtered 
through the uudecode program. This way the file is created automati- 
cally without human intervention. This is possible on the uucp net- 
work by either using sendmail or by making rmail be a link to mail 
instead of mail . In each case, an alias must be created in a master file 
to get the automatic invocation of uudecode. 

If these facilities are not available, the file can be sent to a user on the 
remote machine who can uudecode it manually. 

The encode file has an ordinary text form and can be edited by any 
text editor to change the mode or remote name. 



See Also 

uucp(C), uux(ADM), mail(l) 



Restrictions 

The file is expanded by 35% (3 bytes become 4 plus control informa- 
tion) causing it to take longer to transmit. 
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The user on the remote system who is invoking uudecode (often uucp) 
must have write permission on the specified file. 
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Name 

uustat - uucp status inquiry and job control 



Syntax 

uustat [-a] 

uustat [-m] 

uustat [-p] 

uustat [-q] 

uustat [ -kjobid ] 

uustat [ -r jobid ] 

uustat [ -s system ] [ -uuser ] 



Description 

uustat will display the status of, or cancel, previously specified uucp 
commands, or provide general status on uucp connections to other sys- 
tems. Only one of the following options can be specified with uustat 
per command execution: 

-a Output all jobs in queue. 

-m Report the status of accessibility of all machines, 

-p Execute a ' 'ps -ftp' ' for all the process-ids that are in the 

lock files. 

-q List the jobs queued for each machine. If a status file 

exists for the machine, its date, time and status informa- 
tion are reported. In addition, if a number appears in () 
next to the number of C or X files, it is the age in days of 
the oldest C./X. file for that system. The Retry field 
represents the number of hours until the next possible call. 
The Count is the number of failure attempts. NOTE: for 
systems with a moderate number of outstanding jobs, this 
could take 30 seconds or more of real-time to execute. As 
an example of the output produced by the -q option: 

eagle 3C 04/07- 1 1 :07NO DEVICES AVAILABLE 
mh3bs3 2C 07/07- 10:42SUCCESSFUL 

The above output tells how many command files are waiting for each 
system. Each command file may have zero or more files to be sent 
(zero means to call the system and see if work is to be done). The date 
and time refer to the previous interaction with the system followed by 
the status of the interaction. 

-kjobid Kill the uucp request whose job identification is jobid. 

The killed uucp request must belong to the person issuing 
the uustat command unless one is the super-user. 

-r jobid Rejuvenate jobid. The files associated with jobid are 
touched so that their modification time is set to the 
current time. This prevents the cleanup daemon from 
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deleting the job until the jobs modification time reaches 
the limit imposed by the daemon. 

Either or both of the following options can be specified with uustat: 

-ssys Report the status of all uucp requests for remote system 

sys. 

-nuser Report the status of all uucp requests issued by user. 

Output for both the -s and -u options has the following format: 

eaglenOOOO 4/07-1 1:0 1:03(POLL) 

eagleNlbd7 4/07- 1 1 :07 Seagledan522 /usr/dan/A 

eagleC lbd8 4/07- 1 1 :07 Seagledan59 D.3b2al2ce4924 

4/07-11:07 Seagledanrmail mike 
With the above two options, the first field is the jobid of the job. This 
is followed by the date/time. The next field is either an 'S' or 'R' 
depending on whether the job is to send or request a file. This is fol- 
lowed by the user-id of the user who queued the job. The next field 
contains the size of the file, or in the case of a remote execution ( 
rmail - the command used for remote mail), the name of the command. 
When the size appears in this field, the file name is also given. This 
can either be the name given by the user or an internal name (e.g., 
D.3b2alce4924) that is created for data files associated with remote 
executions {rmail in this example). 

When no options are given, uustat outputs the status of all uucp 
requests issued by the current user. 

Files 

/usr/spool/uucp/* spool directories 

See Also 
uucp(C). 
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Name 

uusub - Monitor uucp network. 



Syntax 

uusub [ options ] 



Description 

uusub defines a uucp subnetwork and monitors the connection and 
traffic among the members of the subnetwork. The following options 
are available: 

-asys Add sys to the subnetwork. 

-dsys Delete sys from the subnetwork. 

-1 Report the statistics on connections. 

-r Report the statistics on traffic amount. 

-f Flush the connection statistics. 

-uhr Gather the traffic statistics over the past hr hours. 

-csys Exercise the connection to the system sys . If sys is specified 

as all, then exercise the connection to all the systems in the 

subnetwork. 

The connections report format is: 

sys #call #ok time #dev #login #nack #other 

where sys is the remote system name, #call is the number of times the 
local system tries to call sys since the last flush was done, #ok is the 
number of successful connections, time is the the latest successful 
connect time, #dev is the number of unsuccessful connections because 
of no available device (e.g. ACU), fflogin is the number of unsuccess- 
ful connections because of login failure, #nack is the number of 
unsuccessful connections because of no response (e.g., line busy, sys- 
tem down), and #other is the number of unsuccessful connections 
because of other reasons. 

The traffic statistics format is: 

sfile sbyte rfile rbyte 

where sfile is the number of files sent and sbyte is the number of bytes 
sent over the period of time indicated in the latest uusub command 
with the -uhr option. Similarly, rfile and rbyte are the numbers of 
files and bytes received. 
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The command: 

uusub -c all -u 24 

is typically started by cron(C) once a day. 



Files 



/usr/spool/uucp/SYSLOG 

system log file 
/usr/lib/uucp/L_sub connection statistics 
/usr/lib/uucp/R_sub traffic statistics 



See Also 

uucp(C), uustat(C). 
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Name 

uuto, uupick - public UNIX-to-UNIX system file copy 



Syntax 

uuto [ options ] source-files destination 
uupick [ -s system ] 



Description 

uuto sends source-files to destination, uuto uses the uucp(C) facility 
to send files, while it allows the local system to control the file access. 
A source-file name is a path name on your machine. Destination has 
the form: 

system! user 

where system is taken from a list of system names that uucp knows 
about (see uuname). User is the login name of someone on the speci- 
fied system. 

Two options are available: 

-p Copy the source file into the spool directory before transmis- 

sion. 

-m Send mail to the sender when the copy is complete. 

The files (or sub-trees if directories are specified) are sent to PUBDIR 
on system, where PUBDIR is a public directory defined in the uucp 
source. By default this directory is /usr/spool/uucppublic. 
Specifically the files are sent to 

PUBDlR/receive/user/mysystem/ files. 

The destined recipient is notified by mail (I) of the arrival of files. 

uupick accepts or rejects the files transmitted to the user. Specifically, 
uupick searches PUBDIR for files destined for the user. For each entry 
(file or directory) found, the following message is printed on the stan- 
dard output: 

from system: [file file-name] [dir dirname] ? 

uupick then reads a line from the standard input to determine the 
disposition of the file: 

<new-line> Go on to next entry. 

d Delete the entry. 
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m [ dir ] 



Move the entry to named directory dir. If dir is not 
specified as a complete path name (in which 
$HOME is legitimate), a destination relative to the 
current directory is assumed. If no destination is 
given, the default is the current directory. 



a [ dir ] 



Same as m except moving all the files sent from 
system . 



P 



Print the content of the file. 



q 



Stop. 



EOT (control-d) Same as q. 



I command 



Escape to the shell to do command. 



* 



Print a command summary. 



uupick invoked with the -ssystem option will only search the PUBDIR 
for files sent from system . 



mail(C), uucp(C), uustat(C), uux(C), uuclean(ADM). 



Warnings 

In order to send files that begin with a dot (e.g., .profile) the files must 
by qualified with a dot. For example: .profile, .prof*, .profil? are 
correct; whereas *prof*, ?profile are incorrect. 
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PUBDIR /usr/spool/uucppublic 



public directory 



See Also 
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Name 

uux - UNIX-to-UNIX system command execution 



Syntax 

uux [ options ] command-string 



Description 

uux will gather zero or more files from various systems, execute a 
command on a specified system and then send standard output to a file 
on a specified system. 

NOTE: For security reasons, most installations limit the list of com- 
mands executable on behalf of an incoming request from uux, permit- 
ting only the receipt of mail (see mail (3)). (Remote execution permis- 
sions are defined in /usr/lib/uucp/Permissions.) 

The command-string is made up of one or more arguments that look 
like a shell command line, except that the command and file names 
may be prefixed by system-name I. A null system-name is interpreted 
as die local system. 

File names may be one of 

(1) a full path name; 

(2) a path name preceded by ~xxx where xxx is a login name on 
the specified system and is replaced by that user's login 
directory; 

(3) anything else is prefixed by the current directory. 
As an example, the command 

uux "!diff usg!/usr/dan/filel pwba!/a4/dan/file2 > !7dan/file.diff" 

will get thefilel mdfile2 files from the "usg" and "pwba" machines, 
execute a diff(l) command and put the results in file. diff in the local 
PUBDIR/dan/ directory. 

Any special shell characters such as <>; | should be quoted either by 
quoting the entire command-string, or quoting the special characters 
as individual arguments. 

uux will attempt to get all files to the execution system. For files that 
are output files, the file name must be escaped using parentheses. For 
example, the command 



June 30, 1988 



Page 1 



UUX(C) 



UUX (C) 



uux a!cut -fl b!/usr/fileXc!/usr/file\) 

gets /usr/file from system "b" and sends it to system "a", performs a cut 
command on that file and sends the result of the cut command to sys- 
tem "c". 

uux will notify you if the requested command on the remote system 
was disallowed. This notification can be turned off by the -n option. 
The response comes by remote mail from the remote machine. 

The following options are interpreted by uux: 

The standard input to uux is made the standard input to 
the command-string . 

-aname Use name as the user identification replacing the initiator 
user-id. (Notification will be returned to the user.) 

-b Return whatever standard input was provided to the uux 

command if the exit status is non-zero. 

-c Do not copy local file to the spool directory for transfer to 

the remote machine (default). 

-C Force the copy of local files to the spool directory for 

transfer. 

-ggrade Grade is a single letter/number; lower ASCII sequence 
characters will cause the job to be transmitted earlier dur- 
ing a particular conversation. 

-j Output the jobid ASCII string on the standard output 

which is the job identification. This job identification can 
be used by uustat to obtain the status or terminate a job. 

-n Do not notify the user if the command fails. 

-p Same as -: The standard input to uux is made the standard 

input to the command-string . 

-r Do not start the file transfer, just queue the job. 

-sfile Report status of the transfer in file. 

-xdebugjevel 

Produce debugging output on the standard output. The 
debug _lev el is a number between and 9; higher numbers 
give more detailed information. 

-z Send success notification to the user. 
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Files 



/usr/spool/uucp/* 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/* 



spool directories 

remote execution permissions 

other data and programs 



See Also 

mail(C), uucp(C), uustat(C). 



Warnings 

Only the first command of a shell pipeline may have a system-name I. 
All other commands are executed on the system of the first command. 
The use of the shell metacharacter * will probably not do what you 
want it to do. The shell tokens « and » are not implemented. 

The execution of commands on remote systems takes place in an exe- 
cution directory known to the uucp system. All files required for the 
execution will be put into this directory unless they already reside on 
that machine. Therefore, the simple file name (without path or 
machine reference) must be unique within the uux request. The fol- 
lowing command will NOT work: 

uux "aldiff b!/usr/dan/xyz c!/usr/dan/xyz > Ixyz.diff" 
but the command 

uux "aldiff a!/usr/dan/xyz c!/usr/dan/xyz > Ixyz.diff ' 
will work. (If diff is a permitted command.) 



Protected files and files that are in protected directories that are owned 
by the requester can be sent in commands using uux. However, if the 
requester is root, and the directory is not searchable by "other," the 
request will fail. 



Notes 
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Name 

vi, view, vedit - Invokes a screen-oriented display editor. 



Syntax 

vi [ -option ... ] [ command ... ] [ filename ... ] 
view [ -option ... ] [ command ... ] [ filename ... ] 
vedit [ -option ... ] [ command ... ] [ filename ... ] 



Description 

vi offers a powerful set of text editing operations based on a set of 
mnemonic commands. Most commands are single keystrokes that 
perform simple editing functions, vi displays a full screen "window" 
into the file you are editing. The contents of this window can be 
changed quickly and easily within vi . While editing, visual feedback 
is provided (the name vi itself is short for "visual' ' ). 

The view command is the same as vi except that the read-only option 
(-R) is set automatically. The file cannot be changed with view . 

The vedit command is the same as vi except for differences in the 
option settings, vedit uses novice mode, turns off the magic option, 
sets the option report=l calls the showmode and sets redraw. 

The showmode option informs the vedit user, in a message in the 
lower right hand corner of the screen, which mode is being used. For 
instance after the ESC-i command is used, the message reads 
"INSERT MODE". 

Note that you can not set the novice option from within vi or ex. If 
you want to use the novice option you must use the vedit utility. (It is 
possible to set the nonovice option from within vedit.) 

vi and the line editor ex are one and the same editor: the names vi and 
ex identify a particular user interface rather than any underlying func- 
tional difference. The differences in user interface, however, are quite 
striking, ex is a powerful line-oriented editor, similar to the editor ed. 
However, in both ex and ed, visual updating of the terminal screen is 
limited, and commands are entered on a command line, vi, on the 
other hand, is a screen-oriented editor designed so that what you see 
on the screen corresponds exactly and immediately to the contents of 
the file you are editing. In the following discussion, vi commands and 
options are printed in boldface type. 
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Options available on the vi command line include: 

-t Equivalent to an initial tag command; edits the file con- 

taining the tag and positions the editor at its definition. 

-r Used in recovering after an editor or system crash, retriev- 

ing the last saved version of the named file. If no file is 
specified, this option prints a list of saved files. 

-I Specific to editing LISP, this option sets the showmatch 

and lisp options. 

-wn Sets the default window size to n. Useful on dialups to 

start in small windows. 

-R Sets a read-only option so that files can be viewed but not 

edited. 



The Editing Buffer 

vi performs no editing operations on the file that you name during 
invocation. Instead, it works on a copy of the file in an "editing 
buffer." 

When you invoke vi with a single filename argument, the named file is 
copied to a temporary editing buffer. The editor remembers the name 
of the file specified at invocation, so that it can later copy the editing 
buffer back to the named file. The contents of the named file are not 
affected until the changes are copied back to the original file. 



Modes of Operation 
Within vi there are three distinct modes of operation: 



Command Mode 



Insert Mode 



ex Escape Mode 



Within command mode, signals from the 
keyboard are interpreted as editing com- 
mands. 

Insert mode can be entered by typing any 
of the vi insert, append, open, substitute, 
change, or replace commands. Once in 
insert mode, letters typed at the key- 
board are inserted into the editing buffer. 

The vi and ex editors are one and the 
same editor differing mainly in their user 
interface. In vi , commands are usually 
single keystrokes. In ex, commands are 
lines of text terminated by a RETURN. 
vi has a special "escape" command that 
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gives access to many of these line- 
oriented ex commands. To use the ex 
escape mode, type a colon (:). The colon 
is echoed on the status line as a prompt 
for the ex command. An executing com- 
mand can be aborted by pressing INTER- 
RUPT. Most file manipulation com- 
mands are executed in ex escape mode 
(for example, the commands to read in a 
file and to write out the editing buffer to 
a file). 



Special Keys 

There are several special keys in vi. The following keys are used to 
edit, delimit, or abort commands and command lines. 



ESC Used to return to vi command mode or to cancel par- 

tially formed commands. 

RETURN Terminates ex commands when in ex escape mode. 
Also used to start a newline when in insert mode. 



INTERRUPT Often the same as the DEL or RUBOUT key on many 
terminals. Generates an interrupt, telling the editor to 
stop what it is doing. Used to abort any command that 
is executing. 

/ Used to specify a string to be searched for. The slash 

appears on the status line as a prompt for a search 
string. The question mark (?) works exactly like the 
slash key, except that it is used to search backward in a 
file instead of forward. 



The colon is a prompt for an ex command. You can 
then type in any ex command, followed by an ESC or 
RETURN, and the given ex command is executed. 



The following characters are special in insert mode: 



BKSP Backs up the cursor one character on the current line. The 
last character typed before the BKSP is removed from the 
input buffer, but remains displayed on the screen. 

Ctrl-U Moves the cursor back to the first character of the inser- 
tion and restarts insertion. 



Ctrl-V Removes the special significance of the next typed char- 
acter. Use Ctrl-V to insert control characters. Linefeed 
and Ctrl-J cannot be inserted in the text except as newline 
characters. Ctrl-Q and Ctrl-S are trapped by the operating 
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system before they are interpreted by vi , so they too can- 
not be inserted as text. 

Ctrl-W Moves the cursor back to the first character of the last 
inserted word. 

Ctrl-T During an insertion, with the autoindent option set and at 
the beginning of the current line, entering this character 
will insert shiftwidth whitespace. 

Ctrl-@ If entered as the first character of an insertion, it is 
replaced with the last text inserted, and the insertion ter- 
minates. Only 128 characters are saved from the last 
insertion. If more than 128 characters were inserted, then 
this command inserts no characters. A Ctrl-@ cannot be 
part of a file, even if quoted. 



Starting and Exiting vi 
To enter vi, enter: 

vi Edits empty editing buffer 

vi file Edits named file 

vi +123 file Goes to line 123 

vi +45 file Goes to line 45 

vi +/word file Finds first occurrence of ' 'word' ' 

vi +/tty file Finds first occurrence of "try" 

There are several ways to exit the editor: 

ZZ The editing buffer is written to the file only if any changes were 
made. 

:x The editing buffer is written to the file only if any changes were 
made. 

:q! Cancels an editing session. The exclamation mark (!) tells vi to 
quit unconditionally. In this case, the editing buffer is not writ- 
ten out. 

vi Commands 

vi is a visual editor with a window on the file. What you see on the 
screen is vz's notion of what the file contains. Commands do not 
cause any change to the screen until the complete command is 
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entered. Most commands may take a preceding count that specifies 
repetition of the command. This count parameter is not given in the 
following command descriptions, but is implied unless overridden by 
some other prefix argument. When vi gets an improperly formatted 
command, it rings a bell. 

Cursor Movement 

The cursor movement keys allow you to move your cursor around in a 
file. Note in particular the direction keys (if available on your termi- 
nal), the H, J, K, and L cursor keys, and SPACEBAR, BKSP, Ctrl-N, and 
Ctrl-P. These three sets of keys perform identical functions. 

Forward Space - 1, SPACEBAR, or right direction key 

Syntax: I 

SPACEBAR 
right direction key 

Function: 

Moves the cursor forward one character. If a count is given, move 
forward count characters. You cannot move past the end of the 
line. 



Backspace 

Syntax: 

Function: 

Next Line 

Syntax: 

Function: 
Syntax: 

Function: 



■ h, BKSP, or left direction key 
h 

BKSP 

left direction key 



Moves cursor backward one character. If a count is given, 
moves backward count characters. Note that you cannot 
move past the beginning of the current line. 

■ +, RETURN, j, Ctrl-N, and LF 

+ 

RETURN 

Moves the cursor down to the beginning of the next line, 
j 

Ctrl-N 
LF 

down direction key 

Moves the cursor down one line, remaining in the same 
column. Note the difference between these commands 
and the preceding set of next line commands which move 
to the beginning of the next line. 
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Previous Line - k, Ctrl-P, and up direction key 

Syntax: k 

Ctrl-P 

up direction key 

Function: Moves the cursor up one line, remaining in the same 
column. If a count is given, the cursor is moved count 
lines. 

Syntax: 

Function: Moves the cursor up to the beginning of the previous line. 
If a count is given, the cursor is moved up a count lines. 

Beginning of Line - and A 

Syntax: 



Function: Moves the cursor to the beginning of the current line. 

Note that always moves the cursor to the first character 
of the current line. The caret (") works somewhat 
differently: it moves to the first character on a line that is 
not a tab or a space. This is useful when editing files that 
have a great deal of indentation, such as program texts. 

End of Line -$ 

Syntax: $ 

Function: Moves the cursor to the end of the current line. Note that 
the cursor resides on top of the last character on the line. 
If a count is given, the cursor is moved forward count-l 
lines to the end of the line. 

Goto Line - G 

Syntax: [linenumber]G 



Function: 



Moves the cursor to the beginning of the line specified by 
linenumber . If no linenumber is given, the cursor moves 
to the beginning of the last line in the file. To find the line 
number of the current line, use Ctrl-G. 



Column 



Syntax: [column]\ 

Function: Moves the cursor to the column in the current line given 
by column . If no column is given, the cursor is moved to 
the first column in the current line. 
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Word Forward - w and W 



Syntax: w 
W 



Function: Moves the cursor forward to the beginning of the next 
word. The lowercase w command searches for a word 
defined as a string of alphanumeric characters separated 
by punctuation or whitespace (i.e., tab, newline, or space 
characters). The uppercase W command searches for a 
word defined as a string of non whitespace characters. 



Back Word - b and B 



Syntax: b 
B 



Function: Moves the cursor backward to the beginning of a word. 

The lowercase b command searches backward for a word 
defined as a string of alphanumeric characters separated 
by punctuation or whitespace (i.e., tab, newline, or space 
characters). The uppercase B command searches for a 
word defined as a string of non-whitespace characters. If 
the cursor is already within a word, it moves backward to 
the beginning of that word. 



End - e and E 



Syntax: e 
E 



Function: Moves the cursor to the end of a word. The lowercase e 
command moves the cursor to the last character of a word, 
where a word is defined as a string of alphanumeric char- 
acters separated by punctuation or whitespace (i.e., tab, 
newline, or space characters). The uppercase E moves the 
cursor to the last character of a word where a word is 
defined as a string of nonwhitespace characters. If the 
cursor is already within a word, it moves to the end of that 
word. 

Sentence - ( and ) 



Syntax: ( 
) 

Function: Moves the cursor to the beginning (left parenthesis) or 
end of a sentence (right parenthesis). A sentence is 
defined as a sequence of characters ending with a period 
( . ), question mark (?), or exclamation mark (!), followed 
by either two spaces or a newline. A sentence begins on 
the first nonwhitespace character following a preceding 
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sentence. Sentences are also delimited by paragraph and 
section delimiters. See below. 



Paragraph - { and } 

Syntax: } 
{ 

Function: Moves the cursor to the beginning ({) or end (}) of a para- 



graph. A paragraph is defined with the paragraphs 
option. By default, paragraphs are delimited by the nroff 
macros ".IP", ".LP", "JP", ".QP", and ".bp". Para- 
graphs also begin after empty lines. 



Function: Moves the cursor to the beginning ([[) or end (]]) of a sec- 



tion. A section is defined with the sections option. By 
default, sections are delimited by the nroff macros ".NH" 
and ".SH". Sections also start at formfeeds (Ctrl-L) and 
at lines beginning with a brace ({). 



Match Delimiter - % 

Syntax: % 

Function: Moves the cursor to a matching delimiter, where a delim- 



iter is a parenthesis, a bracket, or a brace. This is useful 
when matching pairs of nested parentheses, brackets, and 
braces. 



Home - H 

Syntax: [offset]H 

Function: Moves the cursor to the upper left corner of the screen. 



Use this command to quickly move to the top of the 
screen. If an offset is given, the cursor is homed offset -1 
number of lines from the top of the screen. Note that the 
command "dH" deletes all lines from the current line to 
the top line shown on the screen. 



Section - [[ and ]] 



Syntax: 



]] 
[[ 
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Middle Screen - M 

Syntax: M 

Function: Moves the cursor to the beginning of the screen's middle 
line. Use this command to quickly move to the middle of 
the screen from either the top or the bottom. Note that the 
command "dM" deletes from the current line to the line 
specified by the M command. 

Lower Screen - L 

Syntax: [offset]L 

Function: Moves the cursor to the lowest line on the screen. Use 
this command to quickly move to the bottom of the 
screen. If an offset is given, the cursor is homed offset -I 
number of lines from the bottom of the screen. Note that 
the command "dL" deletes all lines from the current line 
to the bottom line shown on the screen. 

Previous Context - " and " 

Syntax: 

'character 
^character 

Function: Moves the cursor to previous context or to context marked 
with the m command. If the single quotation mark or 
back quotation mark is doubled, the cursor is moved to 
previous context. If a single character is given after either 
quotation mark, the cursor is moved to the location of the 
specified mark as defined by the m command. Previous 
context is the location in the file of the last "nonrelative" 
cursor movement. The single quotation mark ( ' ) syntax 
is used to move to the beginning of the line representing 
the previous context. The back quotation mark ( v ) syntax 
is used to move to the previous context within a line. 
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The Screen Commands 

The screen commands are not cursor movement commands and cannot 
be used in delete commands as the delimiters of text objects. How- 
ever, the screen commands do move the cursor and are useful in pag- 
ing or scrolling through a file. These commands are described below: 

Scroll- Ctrl-U and Ctrl-D 

Syntax: [size] Ctrl-U 
|>/ze]Ctrl-D 

Function: Scrolls the screen up a half window (Ctrl-U) or down a 
half window (Ctrl-D). If size is given, the scroll is size 
number of lines. This value is remembered for all later 
scrolling commands. 

Page - Ctrl-F and Ctrl-B 

Syntax: Ctrl-F 
Ctrl-B 

Function: Pages screen forward and backward. Two lines of con- 
tinuity are kept between pages if possible. A preceding 
count gives the number of pages to move forward or back- 
ward. 

Status - Ctrl-G 

Syntax: BELL 
Ctrl-G 

Function: Displays vi status on status line. This gives you the name 
of the file you are editing, whether it has been modified, 
the current line number, the number of lines in the file, 
and the percentage of the file (in lines) that precedes the 
cursor. 

Zero Screen - z 

Syntax: [linenumber]z[size]RETVRN 
[linenumber] z [size] . 
[linenumber]z[size] - 

Function: Redraws the display with the current line placed at or 
"zeroed" at the top, middle, or bottom of the screen, 
respectively. If you give a size, the number of lines 
displayed is equal to size. If a preceding linenumber is 
given, the given line is placed at the top of the screen. If 
the last argument is a RETURN, the current line is placed 
at the top of the screen. If the last argument is a period 
( . ), the current line is placed in the middle of the screen. 
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If the last argument is a minus sign (-), the current line is 
placed at the bottom of the screen. 

Redraw - Ctrl-R or Ctrl-L 

Syntax: Ctrl-R 
Ctrl-L 

Function: Redraws the screen. Use this command to erase any sys- 
tem messages that may scramble your screen. Note that 
system messages do not affect the file you are editing. 

Text Insertion 

The text insertion commands always place you in insert mode. Exit 
from insert mode is always done by pressing ESC. The following 
insertion commands are "pure" insertion commands; no text is 
deleted when you use them. This differs from the text modification 
commands, change, replace, and substitute, which delete and then 
insert text in one operation. 

Insert - i and I 

Syntax: i[text]ESC 
I[text]ESC 

Function: Insert text in editing buffer. The lowercase i command 
places you in insert mode. Text is inserted before the 
character beneath the cursor. To insert a newline, press a 
RETURN. Exit insert mode by typing the ESC key. The 
uppercase I command places you in insert mode, but 
begins text insertion at the beginning of the current line, 
rather than before the cursor. 

Append - a and A 

Syntax: a[tejtf]ESC 
A[te;tf]ESC 

Function: Appends text to the editing buffer. The lowercase a com- 
mand works exactly like the lowercase i command, except 
that text insertion begins after the cursor and not before. 
This is the one way to add text to the end of a line. The 
uppercase A command begins appending text at the end of 
the current line rather than after the cursor. 
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Open New Line - o and O 

Syntax: o[text]ESC 
0[text]ESC 

Function: Opens a new line and inserts text. The lowercase o com- 
mand opens a new line below the current line; uppercase 

opens a new line above the current line. After the new 
line has been opened, both these commands work like the 

1 command. 



Text Deletion 

Many of the text deletion commands use the D key as an operator. 
This operator deletes text objects delimited by the cursor and a cursor 
movement command. Deleted text is always saved away in a buffer. 
The delete commands are described below: 

Delete Character - x and X 

Syntax: x 
X 

Function: Deletes a character. The lowercase x command deletes 
the character beneath the cursor. With a preceding count, 
count characters are deleted to the right beginning with 
the character beneath the cursor. This is a quick and easy 
way to delete a few characters. The uppercase X com- 
mand deletes the character just before the cursor. With a 
preceding count, count characters are deleted backward, 
beginning with the character just before the cursor. 

dandD 

Acursor -movement 
dd 
D 

Function: Deletes a text object. The lowercase d command takes a 
cursor-movement as an argument. If the cursor-movement 
is an intraline command, deletion takes place from the 
cursor to the end of the text object delimited by the 
cursor -movement . Deletion forward deletes the character 
beneath the cursor; deletion backward does not. If the 
cursor-movement is a multi-line command, deletion takes 
place from and including the current line to the text object 
delimited by the cursor-movement . 



Delete - 

Syntax: 
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The dd command deletes whole lines. The uppercase D command 
deletes from and including the cursor to the end of the current line. 

Deleted text is automatically pushed on a stack of buffers numbered 1 
through 9. The most recently deleted text is also placed in a special 
delete buffer that is logically buffer 0. This special buffer is the 
default buffer for all (put) commands using the double quotation mark 
(") to specify the number of the buffer for delete, put, and yank com- 
mands. The buffers 1 through 9 can be accessed with the p and P (put) 
commands by appending the double quotation mark (") to the number 
of the buffer. For example: 

"4p 

puts the contents of delete buffer number 4 in your editing buffer just 
below the current line. Note that the last deleted text is "put" by 
default and does not need a preceding buffer number. 

Text Modification 

The text modification commands all involve the replacement of text 
with other text. This means that some text will necessarily be deleted. 
All text modification commands can be "undone" with the u com- 
mand: 

Undo - u and U 

Syntax: u 
U 

Function: Undoes the last insert or delete command. The lowercase 
u command undoes the last insert or delete command. 
This means that after an insert, u deletes text; and after a 
delete, u inserts text. For the purposes of undo, all text 
modification commands are considered insertions. 

The uppercase U command restores the current line to its 
state before it was edited, no matter how many times the 
current line has been edited since you moved to it. 

Repeat - . 

Syntax: 

Function: Repeats the last insert or delete command. A special case 
exists for repeating the p and P "put" commands. When 
these commands are preceded by the name of a delete 
buffer, successive u commands display the contents of the 
delete buffers. 



May 16, 1988 



Page 13 



V7(C) 



V7(C) 



Change - c and C 

Syntax: ccursor-movement text ESC 
Ctext ESC 
cctext ESC 

Function: Changes a text object and replaces it with text . Text is 
inserted as with the i command. A dollar sign ($) marks 
the extent of the change. The c command changes arbi- 
trary text objects delimited by the cursor and a cursor- 
movement . The C and cc commands affect whole lines 
and are identical in function. 



Replace - r and R 



Syntax: 



xchar 
Rtext ESC 



Function: Overstrikes character or line with char or text , respec- 
tively. Use r to overstrike a single character and R to 
overstrike a whole line. A count multiplies the replace- 
ment text count times. 

Substitute - s and S 



Syntax: 



Function: 



stext ESC 
Stext ESC 

Substitutes current character or current line with text. Use 
s to replace a single character with new text. Use S to 
replace the current line with new text. If a preceding 
count is given, text substitutes for count number of char- 
acters or lines depending on whether the command is s or 
S, respectively. 



Filter 



Syntax: Icursor-movement cmd RETURN 

Function: Filters the text object delimited by the cursor and cursor- 
movement through the XENIX command, cm d. For exam- 
ple, the following command sorts all lines between the 
cursor and the bottom of the screen, substituting the 
designated lines with the sorted lines: 

!Lsort 

Arguments and shell metacharacters may be included as 
part of cm d; however, standard input and output are 
always associated with the text object being filtered. 



May 16, 1988 



Page 14 



VI (C) 



VI (C) 



Join Lines - J 

Syntax: J 

Function: Joins the current line with the following line. If a count is 
given, count lines are joined. 

Shift - < and > 

Syntax: >[cursor-movement] 
<[cursor-movement] 
» 
« 

Function: Shifts text right (>) or left (<). Text is shifted by the value 
of the option shiftwidth, which is normally set to eight 
spaces. Both the > and < commands shift all lines in the 
text object delimited by the current line and cursor- 
movement . The » and « commands affect whole lines. 
All versions of the command can take a preceding count 
that acts to multiply the number of objects affected. 



Text Movement 

The text movement commands move text in and out of the named 
buffers a-z and out of the delete buffers 1-9. These commands either 
"yank" text out of the editing buffer and into a named buffer or "put" 
text into the editing buffer from a named buffer or a delete buffer. By 
default, text is put and yanked from the "unnamed buffer", which is 
also where the most recently deleted text is placed. Thus it is quite 
reasonable to delete text, move your cursor to the location where you 
want the deleted text placed, and then put the text back into the edit- 
ing buffer at this new location with the p or P command. 

The named buffers are most useful for keeping track of several chunks 
of text that you want to keep on hand for later access, movement, or 
rearrangement. These buffers are named with the letters a through z. 
To refer to one of these buffers (or one of the numbered delete buffers) 
in a command, use a quotation mark. For example, to yank a line into 
the buffer named a, enter: 

"ayy 

To put this text back into the file, enter: 
"ap 

If you delete text in the buffer named A rather than a, text is appended 
to the buffer. 
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Note that the contents of the named buffers are not destroyed when 
you switch files. Therefore, you can delete or yank text into a buffer, 
switch files, and then do a put. Buffer contents are destroyed when you 
exit the editor, so be careful. 

Put - p and P 

Syntax: ["alphanumeric]^ 
["alphanumeric]}? 

Function: Puts text from a buffer into the editing buffer. If no buffer 
name is specified, text is put from the unnamed buffer. 
The lowercase p command puts text either below the 
current line or after the cursor, depending on whether the 
buffer contains a partial line or not. The uppercase P 
command puts text either above the current line or before 
the cursor, again depending on whether the buffer contains 
a partial line or not. 

Yank - y and Y 

Syntax: [" letter\y cursor -movement 
["letter]yy 
["letter]Y 

Function: Copies text in the editing buffer to a named buffer. If no 
buffer name is specified, text is yanked into the unnamed 
buffer. If an uppercase letter is used, text is appended to 
the buffer and does not overwrite and destroy the previous 
contents. When a cursor-movement is given as an argu- 
ment, the delimited text object is yanked. The Y and yy 
commands yank a single line, or, if a preceding count is 
given, multiple lines can be yanked. 
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Searching 

The search commands search either forward or backward in the edit- 
ing buffer for text that matches a given regular expression. 

Search - / and ? 

Syntax: /[pattern]/[offset]RETURN 
/[pattem]RETl]RN 
? [pattern] ? [c#ser]RETURN 
?[pattern]RETVRN 

Function: Searches forward (/) or backward (?) for pattern . A string 
is actually a regular expression. The trailing delimiter is 
not required. If no pattern is given, then last pattern 
searched for is used. After the second delimiter, an offset 
may be given, specifying the beginning of a line relative 
to the line on which pattern was found. For example: 

/word/- 

finds the beginning of the line immediately preceding the 
line containing "word" and the following command: 

/word/+2 

finds the beginning of the line two lines after the line con- 
taining "word". See also the ignorecase and magic 
options. 

Next String - n and N 

Syntax: n 
N 

Function: Repeats the last search command. The n command 
repeats the search in the same direction as the last search 
command. The N command repeats the search in the 
opposite direction of the last search command. 

Find Character - f and F 

Syntax: fchar 
Fchar 



Function: Finds character char on the current line. The lowercase f 
searches forward on the line; the uppercase F searches 
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backward. The semicolon (;) repeats the last character 
search. The comma (,) reverses the direction of the 
search. 



To Character - 1 and T 



Syntax: 



tchar 
Tchar 



Function: Moves the cursor up to but not on char. The semicolon 
( ; ) repeats the last character search. The comma ( , ) rev- 
erses the direction of the search. 

Mark - m 

Syntax: mletter 

Function: Marks a place in the file with a lowercase letter . You can 
move to a mark using the "to mark" commands described 
below. It is often useful to create a mark, move the cur- 
sor, and then delete from the cursor to the mark "a" with 
the following command: 

d'a 



To Mark - ' and v 

Syntax: 'letter 
"letter 

Function: Move to letter. These commands let you move to the 
location of a mark. Marks are denoted by single lower- 
case alphabetic characters. Before you can move to a 
mark, it must first be created with the m command. The 
back quotation mark ( " ) moves you to the exact location 
of the mark within a line; the forward quotation mark ( ' ) 
moves you to the beginning of the line containing the 
mark. Note that these commands are also legal cursor 
movement commands. 



Exit and Escape Commands 

There are several commands that are used to escape from vi command 
mode and to exit the editor. These are described in the following sec- 
tion. 
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ex Escape 

Syntax: 



Function: 



Enters ex escape mode to execute an ex command. The 
colon appears on the status line as a prompt for an ex 
command. You then can enter an ex command line ter- 
minated by either a RETURN or an ESC and the ex com- 
mand will execute. You are then prompted to type 
RETURN to return to vi command mode. During the input 
of the ex command line or during execution of the ex 
command, you may press INTERRUPT to stop what you 
are doing and return to vi command mode. 



Exit Editor - ZZ 

Syntax: ZZ 

Function: Exit vi and write out the file if any changes have been 
made. This returns you to the shell from which you 
started vi . 



Quit to ex - Q 

Syntax: Q 



Function: Enters the ex editor. When you do this, you will still be 
editing the same file. You can return to vi by entering the 
vi command from ex. 



ex Commands 

Entering the colon (:) escape command when in command mode pro- 
duces a colon prompt on the status line. This prompt is for a command 
available in the line-oriented editor, ex. In general, ex commands let 
you write out or read in files, escape to the shell, or switch editing 
files. 

Many of these commands perform actions that affect the "current" 
file by default. The current file is normally the file that you named 
when you started vi, although the current file can be changed with the 
"file" command, f, or with the "next" command, n. In most respects, 
these commands are identical to similar commands for the editor, ed. 
All such ex commands are aborted by either RETURN or ESC. We 
shall use RETURN in our examples. Command entry is terminated by 
typing INTERRUPT. 
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Command Structure 

Most ex command names are English words, and initial prefixes of the 
words are acceptable abbreviations. In descriptions, only the abbrevi- 
ation is discussed, since this is the most frequently used form of the 
command. The ambiguity of abbreviations is resolved in favor of the 
more commonly used commands. As an example, the command sub- 
stitute can be abbreviated s , while the shortest available abbreviation 
for the set command is se. 

Most commands accept prefix addresses specifying the lines in the file 
that they are to affect. A number of commands also may take a trail- 
ing count specifying the number of lines to be involved in the com- 
mand. Counts are rounded down if necessary. Thus, the command 
"lOp" displays the tenth line in the buffer while "move 5" moves the 
current line after line 5. 

Some commands take other information or parameters, stated after the 
command name. Examples might be option names in a set command, 
such as "set number", a filename in an edit command, a regular 
expression in a substitute command, or a target address for a copy 
command. For example: 

1,5 copy 25 

A number of commands have variants. The variant form of the com- 
mand is invoked by placing an exclamation mark (!) immediately after 
the command name. Some of the default variants may be controlled 
by options; in this case, the exclamation mark turns off the meaning of 
the default. 

In addition, many commands take flags, including the characters ' 'p' ' 
and "1". A "p" or "1" must be preceded by a blank or tab. In this 
case, the command abbreviated by these characters is executed after 
the command completes. Since ex normally displays the new current 
line after each change, p is rarely necessary. Any number of plus (+) 
or minus (-) characters may also be given with these flags. If they 
appear, the specified offset is applied to the current line value before 
the printing command is executed. 

Most commands that change the contents of the editor buffer give 
feedback if the scope of the change exceeds a threshold given by the 
report option. This feedback helps to detect undesirably large 
changes so that they may be quickly and easily reversed with the undo 
command. After commands with global effect, you will be informed if 
the net change in the number of lines in the buffer during this com- 
mand exceeds this threshold. 
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Command Addressing 

The following specifies the line addressing syntax for ex commands: 

The current line. Most commands leave the current 
line as the last line which they affect. The default 
address for most commands is the current line, thus 
"." is rarely used alone as an address. 

n The «th line in the editor's buffer, lines being num- 

bered sequentially from 1. 

$ The last line in the buffer. 

% An abbreviation for " 1 ,$", the entire buffer. 

+n or -n An offset, n relative to the current buffer line. The 

forms ".+3" "+3" and "+++" are all equivalent. 
If the current line is line 100 they all address line 
103. 

/pattern/ or ? pattern? 

Scan forward and backward respectively for a text 
matching the regular expression given by pattern. 
Scans normally wrap around the end of the buffer. 
If all that is desired is to print the next line contain- 
ing pattern, the trailing slash (/) or question mark 
(?) may be omitted. If pattern is omitted or expli- 
citly empty, the string matching the last specified 
regular expression is located. The forms 
"RETURN" and "7RETURN" scan using the last 
named regular expression. After a substitute, 
"RETURN" and "??RETURN" would scan using 
that substitute's regular expression. 

" or 'x Before each nonrelative motion of the current line 

dot (.), the previous current line is marked with a 
label, subsequently referred to with two single quo- 
tation marks (")• This makes it easy to refer or 
return to this previous context. Marks are esta- 
blished with the vi m command, using a single 
lowercase letter as the name of the mark. Marked 
lines are later referred to with the following nota- 
tion: 

'x. 

where x is the name of a mark. 

Addresses to commands consist of a series of addresses, separated by 
a colon (,) or a semicolon (;). Such address lists are evaluated left to 
right. When addresses are separated by a semicolon (;) the current 
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line ( . ) is set to the value of the previous addressing expression before 
the next address is interpreted. If more addresses are given than the 
command requires, all but the last one or two are ignored. If the com- 
mand takes two addresses, the first addressed line must precede the 
second in the buffer. Null address specifications are permitted in a list 
of addresses, the default in this case is the current line thus 
",100" is equivalent to ".,100". It is an error to give a prefix address 
to a command which expects none. 



Command Format 

The following is the format for all ex commands: 

[address] [command] [!] [parameters] [count] [flags] 

All parts are optional depending on the particular command and its 
options. The following section describes specific commands. 



Argument List Commands 

The argument list commands allow you to work on a set of files, by 
remembering the list of filenames that are specified when you invoke 
vi. The args command lets you examine this list of filenames. The 
file command gives you information about the current file. The n 
(next) command lets you either edit the next file 
in the argument list or change the list. And the rewind command lets 
you restart editing the files in the list. All of these commands are 
described below: 

args The members of the argument list are displayed, with 

the current argument delimited by brackets. 
For example, a list might look like this: 

filel file2 [file3] file4 file5 

The current file is file3. 

f Displays the current filename, whether it has been 

modified since the last write command, whether it is 
read-only, the current linenumber, the number of 
lines in the buffer, and the percentage of the buffer 
that you have edited. In the rare case that the current 
file is ' ' [Not edited] ' ', this is noted also; in this case 
you have to use w! to write to the file, since the edi- 
tor is not sure that a w command will not destroy a 
file unrelated to the current contents of the buffer. 

ffile The current filename is changed to file which is con- 

sidered " [Not edited] 
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n The next file in the command line argument list is 

edited. 

n! This variant suppresses warnings about the 

modifications to the buffer not having been written 
out, discarding irretrievably any changes that may 
have been made. 

n [+command\filelist 

The specified file list is expanded and the resulting 
list replaces the current argument list; the first file in 
the new list is then edited. If command is given (it 
must contain no spaces), then it is executed after 
editing the first such file. 

rew The argument list is rewound, and the first file in the 

list is edited. 

rew! Rewinds the argument list discarding any changes 

made to the current buffer. 

If you use C-Shell and set the prompt variable to output a prompt for 
non-interactive- shells, the prompt is interpreted as a filename when 
you use these commands. This causes unexpected problems. To avoid 
these problems, use the default prompt value as specified in 
lusrll iblmkuserlmkuser. cshrc . 



Edit Commands 

To edit a file other than the one you are currently editing, you will 
often use one of the variations of the e command. 

In the following discussions, note that the name of the current file is 
always remembered by vi and is specified by a percent sign (%). The 
name of the previous file in the editing buffer is specified by a number 
sign (#). 

The edit commands are described below: 

efile Used to begin an editing session on a new file. The edi- 

tor first checks to see if the buffer has been modified 
since the last w command was issued. If it has been, a 
warning is issued and the command is aborted. The 
command otherwise deletes the entire contents of the 
editor buffer, makes the named file the current file, and 
displays the new filename. After ensuring that this file 
is sensible, (i.e., that it is not a binary file, directory, or 
a device), the editor reads the file into its buffer. If the 
read of the file completes without error, the number of 
lines and characters read is displayed on the status line. 
If there were any non- ASCII characters in the file, they 
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are stripped of their non-ASCII high bits, and any null 
characters in the file are discarded. If none of these 
errors occurred, the file is considered edited. If the last 
line of the input file is missing the trailing newline 
character, it is supplied and a complaint issued. The 
current line is initially the first line of the file. 

el file This variant form suppresses the complaint about 

modifications having been made and not written from 
the editor buffer, thus discarding all changes that have 
been made before editing the new file. 

e +nfile Causes the editor to begin editing at line n rather than 
at the first line. The argument n may also be an editor 
command containing no spaces; for example, "+/pat- 
tern". 



Ctrl- A This is a shorthand equivalent for ":e #RETURN", 

which returns to the previous position in the last edited 
file. If you do not want to write the file, you should use 
":e! #RETURN" instead. 



Write Commands 

The write commands let you write out all or part of your editing buffer 
to either the current file or to some other file. These commands are 
described below: 

wfile Writes changes made back to file, displaying the 

number of lines and characters written. Normally, file 
is omitted and the buffer is written to the name of the 
current file. If file is specified, text is written to that 
file. The editor writes to a file only if it is the current 
file and is edited, or if the file does not exist. Other- 
wise, you must give the variant form w! to force the 
write. If the file does not exist it is created. The 
current filename is changed only if there is no current 
filename; the current line is never changed. 

If an error occurs while writing the current and edited 
file, the editor displays: 

No write since last change 

even if the buffer had not previously been modified. 

w» file Appends the buffer contents at the end of an existing 
file. Previous file contents are not destroyed. 
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w! name Overrides the checking of the normal write command, 
and writes to any file that the system permits. 

w \command 

Writes the specified lines into command. Note the 
difference between 

v/lfile 

which overrides checks and 
w \cmd 

which writes to a command. The output of this com- 
mand is displayed on the screen and not inserted in the 
editing buffer. 



Read Commands 

The read commands let you read text into your editing buffer at any 
location you specify. The text you read in must be at least one line 
long, and can be either a file or the output from a command. 

rfile Places a copy of the text of the given file in the editing 

buffer after the specified line. If no file is given, the 
current filename is used. The current filename is not 
changed unless there is none, in which case the file 
becomes the current name. If the file buffer is empty 
and there is no current name, this is treated as an e 
command. 

Address is legal for this command and causes the file 
to be read at the beginning of the buffer. Statistics are 
given as for the e command when the r successfully ter- 
minates. After an r the current line is the last line read. 

r [command Reads the output of command into the buffer after the 
specified line. A blank or tab before the exclamation 
mark (!) is mandatory. 



Quit Commands 

There are several ways to exit vi. Some abort the editing session, 
some write out the editing buffer before exiting, and some warn you if 
you decide to exit without writing out the buffer. All of these ways of 
exiting are described below: 

q Exits vi . No automatic write of the editor buffer to a file 

is performed. However, vi displays a warning message if 
the file has changed since the last w command was issued, 
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and does not quit, vi also displays a diagnostic if there are 
more files in the argument list left to edit. Normally, you 
will wish to save your changes, and you should enter a w 
command. If you wish to discard them, enter the q! com- 
mand variant. 



q! Quits from the editor, discarding changes to the buffer 

without complaint. 

wq name Like a w and then a q command. 

wq! name Overrides checking normally made before execution of 
the w command to any file. For example, if you own a file 
but do not have write permission turned on, the wq! 
allows you to update the file anyway. 

x name If any changes have been made and not written, writes the 
buffer out and then quits. Otherwise, it just quits. 



Global and Substitute Commands 

The global and substitute commands allow you to perform complex 
changes to a file in a single command. Learning how to use these 
commands is a must for an experienced vi user. 

glpatternl cmds 

The g command has two distinct phases. In the first 
phase, each line matching pattern in the editing buffer is 
marked. Next, the given command list is executed with 
the current line, dot ( . ), initially set to each marked line. 

The command list consists of the remaining commands on 
the current input line and may continue to multiple lines 
by ending all but the last such line with a backslash (\). 
This multiple-line option will not work from within vi, 
you must switch to ex to do it. If cmds (or the trailing 
slash (/) delimiter) is omitted, each line matching pattern 
is displayed. 

The g command itself may not appear in cmds. The 
options autoprint and autoindent are inhibited during a 
global command and the value of the report option is 
temporarily infinite, in deference to a report for the entire 
global. Finally, the context mark ( ' ) or ( v ) is set to the 
value of the current line ( . ) before the global command 
begins and is not changed during a global command. 

The following global commands, most of them substitu- 
tions, cover the most frequent uses of the global com- 
mand. 
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g/sl/p This command simply prints all lines that contain 

the string "si" . 

g/sl/s//s2/ This command substitutes the first occurrence of 

"si" on all lines that contain it with the string 
"s2". 



g/sl/s//s2/g This command substitutes all occurrences of "si" 

with the string "s2". This includes multiple 
occurrences of "si" on a line. 



g/sl/s//s2/gp This command works the same as the preceding 
example, except that in addition, all changed lines 
are displayed on the screen. 

g/sl/s//s2/gc This command prompts you to confirm that you 
want to make each substitution of the string "si" 
with the string "s2". If you enter a Y , the given 
substitution is made, otherwise it is not. 

g/s0/s/sl/s2/g This command marks all those lines that contain the 
string "sO", and then for those lines only, substi- 
tutes all occurrences of the string "si" with "s2". 

gMpatternlcmds This variant form of g runs cmds at each line not 
matching pattern . 



g/7s// /g This command inserts blank spaces at the beginning 

of each line in a file. 



slpatternl repll options 

On each specified line, the first instance of text 
matching the regular expression pattern is replaced 
by the replacement text repl. If the global indicator 
option character g appears, all instances on a line 
are substituted. If the confirm indication character 
c appears, before each substitution the line to be 
substituted is printed on the screen with the string 
to be substituted marked with caret (~) characters. 
By entering Y , you cause the substitution to be per- 
formed; any other input causes no change to take 
place. After an s command, the current line is the 
last line substituted. 



v/pattern/cmds A synonym for the global command variant g!, run- 
ning the specified cmds on each line that does not 
match pattern . 
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Text Movement Commands 

The text movement commands are largely superseded by commands 
available in vi command mode. However, the following two com- 
mands are still quite useful: 

co addr flags A copy of the specified lines is placed after addr, 
which may be "0". The current line "." addresses 
the last line of the copy. 

[range]maddr The m command moves the lines specified by range 
after the line given by addr. For example, m+ 
swaps the current line and the following line, since 
the default range is just the current line. The first of 
the moved lines becomes the current line (dot). 



Shell Escape Commands 

You will often want to escape from the editor to execute normal 
XENIX commands. You may also want to change your working direc- 
tory so that your editing can be done with respect to a different work- 
ing directory. These operations are described below: 

cd directory The specified directory becomes the current direc- 
tory. If no directory is specified, the current value 
of the home option is used as the target directory. 
After a cd , the current file is not considered to have 
been edited so that write restrictions on preexisting 
files still apply. 

sh A new shell is created. You may invoke as many 

commands as you like in this shell. To return to vi , 
enter a Ctrl-D to terminate the shell. 

I command The remainder of the line after the exclamation (!) 

is sent to a shell to be executed. Within the text of 
command , the characters "%" and "#" are 
expanded as the filenames of the current file and the 
last edited file and the character "!" is replaced 
with the text of the previous command. Thus, in 
particular, "!!" repeats the last such shell escape. 
If any such expansion is performed, the expanded 
line is echoed. The current line is unchanged by 
this command. 

If there has been ' ' [No write] ' ' of the buffer contents since the last 
change to the editing buffer, a diagnostic is displayed before the com- 
mand is executed as a warning. A single exclamation (!) is displayed 
when the command completes. 
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If you use C-Shell and set the prompt variable to output a prompt for 
non-interactive shells, the prompt is interpreted as an argument for 
command in shell escapes. This causes unexpected problems. To 
avoid these problems, use the default prompt value as specified in 
/ usrl lib I mkuserlmkuser.cshrc . 



Other Commands 

The following command descriptions explain how to use miscellane- 
ous ex commands that do not fit into the above categories: 

abbr Maps the first argument to the following string. For exam- 
ple, the following command 

:abbr rainbow yellow green blue red 

maps "rainbow" to "yellow green blue red". Abbrevia- 
tions can be turned off with the unabbreviate command, 
as in: 

:una rainbow 

map, map! Maps any character or escape sequence to an existing 
command sequence. Characters mapped with map! work 
in both command and insert mode, while characters 
mapped with map work only in command mode. Charac- 
ters mapped with map! cannot be unmapped using 
unmap. 

nu Displays each specified line preceded by its buffer line 

number. The current line is left at the last line displayed. 
To get automatic line numbering of lines in the buffer, set 
the number option. 

preserve The current editor buffer is saved as though the system 
had just crashed. This command is for use only in emer- 
gencies when a w command has resulted in an error and 
you do not know how to save your work. 

= Displays the line number of the addressed line. The 

current line is unchanged. 

recover file 

Recovers file from the system save area. The system 
saves a copy of the editing buffer only if you have made 
changes to the file, the system crashes, or you execute a 
preserve command. When you use preserve , you are 
notified by mail when a file is saved. 
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set argument 

With no arguments, set displays those options whose 
values have been changed from their defaults; with the 
argument all, it displays all of the option values. 

Giving an option name followed by a question mark (?) causes the 
current value of that option to be displayed. The question mark is 
unnecessary unless the option is a Boolean value. Switch options are 
given values either with: 

set option 

to turn them on or: 

set nooption 

to turn them off. String and numeric options are assigned with: 
set option=vahiQ 

More than one option may be given to set ; all are interpreted from left 
to right. The option values can be set automatically with the EXINIT 
environment variable. For more information, see environ(M). 

tag label 

The focus of editing switches to the location of label . If necessary, 
vi will switch to a different file in the current directory to find 
label. If you have modified the current file before giving a tag 
command, you must first write it out. If you give another tag com- 
mand with no argument, the previous label is used. 

Similarly, if you press Ctrl-], vi searches for the word immediately 
after the cursor as a tag. This is equivalent to entering ":tag", the 
word following the cursor, and then pressing the RETURN key. 

The tags file is normally created by a program such as ctags, and 
consists of a number of lines with three fields separated by blanks 
or tabs. The first field gives the name of the tag, the second the 
name of the file where the tag resides, and the third gives an 
addressing form which can be used by the editor to find the tag. 
This field is usually a contextual scan using /pattern/ to be 
immune to minor changes in the file. Such scans are always per- 
formed as if the nomagic option was set. The tag names in the 
tags file must be sorted alphabetically. There are a number of 
options that can be set to affect the vi environment. These can be 
set with the ex set command either while editing or immediately 
after vi is invoked in the vi start-up file, .exrc. 

unmap 

Unmaps any character or escape sequence that has been mapped 
using the map command. 
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The first thing that must be done before you can use vi , is to set the 
terminal type so that vi understands how to talk to the particular termi- 
nal you are using. 

Each time vi is invoked, it reads commands from the file named .exrc 
in your home directory. This file normally sets the user's preferred 
options so that they need not be set manually each time you invoke vi . 
Each of the options is described in detail below. 



Options 

There are only two kinds of options: switch options and string options. 
A switch option is either on or off. A switch is turned off by prefixing 
the word no to the name of the switch within a set command. String 
options are strings of characters that are assigned values with the syn- 
tax option= string . Multiple options may be specified on a line, vi 
options are listed below: 

autoindent, ai default: noai 

Can be used to ease the preparation of structured program text. For 
each line created by an append, change, insert, open, or substitute 
operation, vi looks at the preceding line to determine and insert an 
appropriate amount of indentation. To back the cursor up to the 
preceding tab stop, press Ctrl-D. The tab stops going backward are 
defined as multiples of the shiftwidth option. You cannot back- 
space over the indent, except by pressing Ctrl-D. 

Specially processed in this mode is a line with no characters added 
to it, which turns into a completely blank line (the whitespace pro- 
vided for the autoindent is discarded). Also, specially processed 
in this mode are lines beginning with a caret ( " ) and immediately 
followed by a Ctrl-D. This causes the input to be repositioned at 
the beginning of the line, but retains the previous indent for the 
next line. Similarly, a "0" followed by a Ctrl-D, repositions the 
cursor at the beginning without retaining the previous indent. 
Autoindent doesn't happen in global commands. 

autoprint ap default: ap 

Causes the current line to be displayed after each ex copy, move, 
or substitute command. This has the same effect as supplying a 
trailing "p" to each such command. Autoprint is suppressed in 
globals, and only applies to the last command on a line. 

autowrite, aw default: noaw 

Causes the contents of the buffer to be automatically written to the 
current file if you have modified it when you give a next, rewind, 
tag, or ! command, or a Ctrl-" (switch files) or Ctrl-] (tag go to) 
command. 
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beautify, bf default: nobeautify 

Causes all control characters except tab, newline and formfeed to 
be discarded from the input. A complaint is registered the first 
time a backspace character is discarded. Beautify does not apply 
to command input. 

directory, dir default: dir=/tmp 

Specifies the directory in which vi places the editing buffer file. If 
the directory does not have write permission, the editor will exit 
abruptly when it fails to write to the buffer file. 

edcompatible default: noedcompatible 

Causes the presence or absence of g and c suffixes on substitute 
commands to be remembered, and to be toggled on and off by 
repeating the suffixes. The suffix r causes the substitution to be like 
the tilde (") command, instead of like the ampersand command 
(&)• 

errorbells, eb default: noeb 

Error messages are preceded by a bell. If possible, the editor 
always places the error message in inverse video instead of ringing 
the bell. 

hardtabs, ht default: ht=8 

Gives the boundaries on which terminal hardware tabs are set or on 
which tabs the system expands. 

ignorecase, ic default: noic 

Maps all uppercase characters in the text to lowercase in regular 
expression matching. In addition, all uppercase characters in regu- 
lar expressions are mapped to lowercase except in character class 
specifications enclosed in brackets. 

lisp default: nolisp 

Autoindent indents appropriately for LISP code, and the ( ) { } [[ 
and ]] commands are modified to have meaning for LISP. 

list default: nolist 

All printed lines are displayed, showing tabs and end-of-lines. 

magic default: magic 

If nomagic is set, the number of regular expression metacharacters 
is greatly reduced, with only up-arrow Q and dollar sign ($) hav- 
ing special effects. In addition, the metacharacters "~" and "&" 
in replacement patterns are treated as normal characters. All the 
normal metacharacters may be made magic when nomagic is set 
by preceding them with a backslash (\). 

mesg default: nomesg 

Causes write permission to be turned off to the terminal while you 
are in visual mode, if nomesg is set. This prevents people writing 
to your screen with the XENIX write command and scrambling 
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your screen as you edit. 

number, n default: nonumber 

Causes all output lines to be printed with their line numbers. 

open default: open 

If set to noopen, the commands open and visual are not permitted 
from ex. This is set to prevent confusion resulting from accidental 
entry to open or visual mode. 

optimize, opt default: optimize 

Output of text to the screen is expedited by setting the terminal so 
that it does not perform automatic carriage returns when displaying 
more than one line of output, thus greatly speeding output on ter- 
minals without addressable cursors when text with leading whi- 
tespace is printed. 

paragraphs, para default: para =IPLPPPQPP TPbp 

Specifies paragraph delimiters for the { and } operations. The pairs 
of characters in the option's value are the names of the nroff mac- 
ros that start paragraphs. 

prompt default: prompt 

ex input is prompted for with a colon (:). If noprompt is set, when 
ex command mode is entered with the Q command, no colon 
prompt is displayed on the status line. 

redraw default: noredraw 

The editor simulates (using great amounts of output), an intelligent 
terminal on a dumb terminal. Useful only at very high speed. 

remap default: remap 

If on, mapped characters are repeatedly tried until they are 
unchanged. For example, if o is mapped to O and O is mapped to /, 
o will map to / if remap is set, and to O if noremap is set. 

report default: report=5 

Specifies a threshold for feedback from commands. Any command 
that modifies more than the specified number of lines will provide 
feedback as to the scope of its changes. For global commands and 
the undo command, the net change in the number of lines in the 
buffer is presented at the end of the command. Thus notification is 
suppressed during a g command on the individual commands per- 
formed. 

scroll default: scroll^/2 window 

Determines the number of logical lines scrolled when Ctrl-D is 
received from a terminal input in command mode, and the number 
of lines displayed by a command mode z command (double the 
value of scroll). 
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sections default: sections=SHNHH HU 

Specifies the section macros for the [[ and ]] operations. The pairs 
of characters in the option's value are the names of the nroff mac- 
ros that start paragraphs. 

shell, sh default: sh=/bin/sh 

Gives the pathname of the shell forked for the shell escape com- 
mand (!), and by the shell command. The default is taken from 
SHELL in the environment, if present. 

shiftwidth, sw default:sw=8 

Gives the width of a software tab stop, used in reverse tabbing with 
Ctrl-D when using autoindent to append text, and by the shift com- 
mands. 

showmatch, sm default: nosm 

When a ) or } is typed, moves the cursor to the matching ( or { for 
one second if this matching character is on the screen. 

showmode default: noshowmode 

Causes the message "INPUT MODE to appear on lower right 
corner of the screen when insert mode is activated. 

slowopen default: noslowopen 

Postpones update of the display during inserts. 

tabstop, ts default: ts=8 

The editor expands tabs in the input file to be on n boundaries for 
the purposes of display. 

taglength, tl default: tl=0 

The first n characters in a tag name are significant, but all others 
are ignored. A value of zero (the default) means that all characters 
are significant. 

tags default: tags=tags /usr/lib/tags 

A path of files to be used as tag files for the tag command. A 
requested tag is searched for in the specified files, sequentially. By 
default, files named tag are searched for in the current directory 
and in /usr/lib. 

term default=value of shell TERM variable 
The terminal type of the output device. 

terse default: noterse 

Shorter error diagnostics are produced for the experienced user. 

timeout , to default: noto 

Eliminates the 1 second time limit for maps (character mappings). 
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warn default: warn 

Warn if there has been "[No write since last change]" before a 
shell escape command (!). 

window default: window = speed dependent 

This specifies the number of lines in a text window. The default is 
8 at slow speeds (600 baud or less), 16 at medium speed (1200 
baud), and the full screen (minus one line) at higher speeds. 

w300, wl200, w9600 

These are not true options but set window (above) only if the 
speed is slow (300), medium (1200), or high (9600), respectively. 

wrapscan, ws default: ws 

Searches, using the regular expressions in addressing, will wrap 
around past the end of the file. 

wrapmargin, wm default: wm=0 

Defines the margin for automatic insertion of newlines during text 
input. A value of zero specifies no wrap margin. 

writeany, wa default: nowa 

Inhibits the checks normally made before write commands, allow- 
ing a write to any file that the system protection mechanism will 
allow. 



Regular Expressions 

A regular expression specifies a set of strings of characters. A 
member of this set of strings is said to be ' 'matched' ' by the regular 
expression, vi remembers two previous regular expressions: the pre- 
vious regular expression used in a substitute command and the previ- 
ous regular expression used elsewhere, referred to as the previous 
scanning regular expression. The previous regular expression can 
always be referred to by a null regular expression: e.g., ' '//' ' or "??' '. 

The regular expressions allowed by vi are constructed in one of two 
ways depending on the setting of the magic option. The ex and vi 
default setting of magic gives quick access to a powerful set of regu- 
lar expression metacharacters. The disadvantage of magic is that the 
user must remember that these metacharacters are magic and precede 
them with the backslash (\) to use them as "ordinary" characters. 
With nomagic set, regular expressions are much simpler, there being 
only two metacharacters. The power of the other metacharacters is 
still available by preceding the now ordinary character with a "\". 
Note that ' 'V ' is always a metacharacter. In this discussion, the magic 
option is assumed. With nomagic , the only special characters are the 
caret Q at the beginning of a regular expression, the dollar sign ($) at 
the end of a regular expression, and the backslash (\). The tilde (~) 
and the ampersand (&) also lose their special meanings related to the 
replacement pattern of a substitute. 
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The following basic constructs are used to construct magic mode reg- 
ular expressions. 

char An ordinary character matches itself. Ordinary characters are 
any characters except a caret (") at the beginning of a line, a 
dollar sign ($) at the end of line, a star (*) as any character other 
than the first, and any of the following characters: 

.\[~ 

These characters must be preceded by a backslash (\) if they are 
to be treated as ordinary characters. 

At the beginning of a pattern, forces the match to succeed only 
at the beginning of a line. 

$ At the end of a regular expression, forces the match to succeed 
only at the end of the line. 

Matches any single character except the newline character. 

\< Forces the match to occur only at the beginning of a "word"; 
that is, either at the beginning of a line, or just before a letter, 
digit, or underline and after a character not one of these. 

\> Similar to "\<", but matching the end of a "word", i.e., either 
the end of the line or before a character which is not a letter, a 
digit, or the underline character. 

[string] 

Matches any single character in the class defined by string. 
Most characters in string define themselves. A pair of charac- 
ters separated by a dash (-) in string defines the set of characters 
between the specified lower and upper bounds, thus ' ' [a-z] " as a 
regular expression matches any single lowercase letter. If the 
first character of string is a caret ( " ) then the construct matches 
those characters which it otherwise would not. Thus ' ' Ta-z] ' ' 
matches anything but a lowercase letter or a newline. To place 
any of the characters caret, left bracket, or dash in string they 
must be escaped with a preceding backslash (\). 

The concatenation of two regular expressions first matches the left- 
most regular expression and then the longest string that can be recog- 
nized as a regular expression. The first part of this new regular 
expression matches the first regular expression and the second part 
matches the second. Any of the single character matching regular 
expressions mentioned above may be followed by a star () to form a 
regular expression that matches zero or more adjacent occurrences of 
the characters matched by the prefixing regular expression. The tilde 
(~) may be used in a regular expression to match the text that defined 
the replacement part of the last s command. A regular expression may 
be enclosed between the sequences "\(" and "\)" to remember the 
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text matched by the enclosed regular expression. This text can later 
be interpolated into the replacement text using the following notation: 

\iigit 

where digit enumerates the set of remembered regular expressions. 

The basic metacharacters for the replacement pattern are the amper- 
sand (&) and the tilde (~); these are given as "\&" and "V" when 
nomagic is set. Each instance of the ampersand is replaced by the 
characters matched by the regular expression. In the replacement pat- 
tern, the tilde stands for the text of the previous replacement pattern. 

Other metasequences possible in the replacement pattern are always 
introduced by a backslash (\). The sequence "W is replaced by the 
text matched by the nth regular subexpression enclosed between "X" 
and "\)'\ When nested, parenthesized subexpressions are present, n is 
determined by counting occurrences of "\(" starting from the left. 
The sequences "\u" and "XT' cause the immediately following char- 
acter in the replacement to be converted to uppercase or lowercase, 
respectively, if this character is a letter. The sequences "\U" and 
"XL" turn such conversion on, either until "\E" or "\e" is encoun- 
tered, or until the end of the replacement pattern. 



Credit 

This utility was developed at the University of California at Berkeley 
and is used with permission. 



Notes 

The /usr/Iib/ex3.7preserve program can be used to restore vi buffer 
files that were lost as a result of a system crash. The program searches 
the /tmp directory for vi buffer files and places them in the directory 
/usr/preserve. The owner can retrieve these files using the -r option. 

The /usr/Iib/ex3.7preserve program must be placed in the system 
startup file, /etc/rc, before the command that cleans out the /tmp 
directory. See the XENIX System Administrator's Guide for more in- 
formation on /etc/rc. 
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Name 

vidi - Sets the font and video mode for a video device. 



Syntax 

vidi [ -d ] [ -f fontfile ] command 



Description 

vidi sets video mode or loads/extracts a font from the device that is the 
current standard input; without arguments, it lists the all of the valid 
video mode and font commands. 

Some video cards support changeable character fonts. The vidi font 
commands ("font8x8", "font8xl4", and "font8xl6") are used to load 
and extract fonts from the tables stored in the kernel. If neither of the 
-d or -f options has been specified, vidi will attempt to load the speci- 
fied font from /usr/lib/vidi/f ontname. The -d option causes vidi to read 
the specifed font from the kernel and write (dump) the font to the stan- 
dard output. 

The -f option is used to load fonts other than those in /usr/lib/vidi or to 
specify an output file other than standard output. When loading a font, 
-f filename will load the font from filename instead of from 
/usr/lib/vidi// bntname. When extracting a font (-d option) -f filename 
causes vidi to write the extracted font into filename instead of writing 
the font to the standard output. 

The other vidi commands set the video mode of the video adapter con- 
nected to vidVs, standard input. The commands are : 

mono 

move current screen to the monochrome adapter. 

cga 

move current screen to the Color Graphics adapter. 

ega 

move current screen to the Enhanced Graphics adapter. 

vga 

move current screen to the Video Graphics adapter. 
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Text Modes 


Command 


Cols 


Rows 


Font 


Adapter 




c40x25 


40 


25 


8x8 


CGA (EGA VGA) 




e40x25 


40 


25 


8x14 


EGA (VGA) 




v40x25 


40 


25 


8x16 


VGA 




m80x25 


80 


25 


8x14 


MONO (EGA_MONO VGA_MONO) 


c80x25 


80 


25 


8x8 


CGA (EGA VGA) 




em80x25 


on 
oO 


25 


0„ 1 A 

8x14 


EGA_MONO (VGA_MONO) 


e80x25 


80 


25 


8x14 


EGA (VGA) 




vm80x25 


80 


25 


8x16 


VGA MONO 




v80x25 


80 


25 


8x16 


VGA 




e80x43 


80 


43 


8x14 


EGA (VGA) 






Graphics Modes 


Command 




Pixel Resolution 


Colors 


mode5 






320x200 




4 


mode6 






640x200 




2 


modeD 






320x200 




16 


modeE 






640x200 




16 


modeF 






640x350 




2 (mono) 


mode 10 






640x350 




16 


model 1 






640x480 




2 


mode 12 






640x480 




16 


mode 13 






320x200 




256 



See Also 

screen(HW) 
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Name 

vmstat - Report paging and system statistics. 



Syntax 

vmstat [ -fs ] [ -n namelist ] [ -1 lines ] [ interval [ count ]] 



Description 

vmstat reports some statistics kept by the system on processes, 
demand paging, and cpu and trap activity. Three types of reports are 
available: 

(default) 

A summary of the number of processes in various states, paging 
activity, system activity, and cpu cycle consumption. 

-f Number of fork(S)'s done. 

-s A verbose listing of paging and trap activity. 

If no interval or count is specified, the totals since system bootup are 
displayed. 

If an interval is given, the number of events that have occurred in the 
last interval seconds is shown. If no count is specified, this display is 
repeated forever every interval seconds. Otherwise, when a count is 
also specified, the information is displayed count times. 

Other flags that may be specified include: 

-c corefile 

Uses the file corefile in place of /dev/kmem. 
-n namelist 

Use file namelist as an alternate symbol table instead of /xenix. 
-I lines 

For the default display, repeat the header every lines reports 
(default is 20). 

The fields in the default report are: 

procs 

The number of processes which are: 
r In the run queue. 
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b Blocked waiting for resources, 
w Swapped out. 

These values always reflect the current situation, even if the totals 
since boot are being displayed. 

paging 

Reports on the performance of the demand paging system. Unless 
the totals since boot are being displayed, this information is aver- 
aged over the proceeding interval seconds: 

si Number of processes swapped in. 

so Number of processes swapped out. 

ch Page cache hits. 

cm 

Page cache misses, 
ffr Filesystem page reads, 
swr 

Swap area page reads, 
sww 

Swap area page writes. 

rec 

Number of pages reclaimed from the free list. 

shf 

Number of pages shared as copy-on- write after fork. 

she 

Number of pages shared due to cache hits. 

cpy 

Number of shared pages copied, 
pf Number of page faults, 
system 

Reports on the general system activity. Unless the totals since 
boot are being shown, these figures are averaged over the last 
interval seconds: 

in Number of (non-clock) device interrupts. 
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sy Number of system calls, 
cs Number of context switches, 
cpu 

Percentage of cpu cycles spent in various operating modes: 
us User, 
su System, 
id Idle. 

This information may not be displayed on some systems. 

The -f and -s reports are a series of lines of the form: 

number description 
which means that number of the items described by description hap- 
pened (either since boot or in the last interval seconds, as appropri- 
ate). These reports should be self-explanatory. 



Files 

/xenix 

Default namelist. 

/dev/kmem 

Default source of statistics. 



Notes 



This utility is only applicable to 
80386-based machines and may not 
be included in your distribution. 



See Also 

fork(S), ps(C), pstat(C) 
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Name 

vsh - menu driven visual shell 



Syntax 
vsh 



Description 

vsh is a highly interactive, visually oriented shell which eases many 
XENIX activities. The vsh features both standard and customizable 
XENIX command menus and on-line help. The vsh displays informa- 
tion and menus in windows on the screen. To enter vsh, simply enter: 

vsh 

from a shell prompt, vsh can also be made a user's default shell by 
changing their shell entry in /etc/passwd (the last colon-separated 
field). Help is available from all menus by typing the question mark 
character. 

The very last line of the screen is a status line. The status line 
displays the current pathname, the date, time and operating system 
name. If you have new mail, the status line will indicate so. Above 
the status line is the message line, which displays messages, error or 
otherwise, from vsh. 

A command menu is displayed at the bottom of the screen. The stan- 
dard menu contains a range of commonly used XENIX commands. 
Above the command menu is the output window. This window con- 
tains a scrolling display of the output from commands. This window 
is not visible at start-up, but is displayed while running certain com- 
mands such as '='. 

In the top of the screen is a window with a listing of the current work- 
ing directory. To alter the size of this window, use the Window com- 
mand from the main command menu. Items in the listing window may 
be selected using standard key commands (q.v.). Two special key 
commands are used with the listing window. The equals sign '=' 
('SHOW') key, displays the contents of the currently selected file or 
directory. The minus sign '-' ('GOAWAY') key, returns you to the 
listing window. 
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Commands may be invoked in one of two ways. A command can be 
selected by pressing the first letter of its name. Alternatively, press 
the space bar. Each time the space bar is pressed, the next menu item 
is highlighted. This highlighting indicates that the command has been 
selected. Backspace moves to the previous selection. 

Once a command is selected, press the return key. A menu is 
displayed which gives the valid arguments for the particular com- 
mand. The default choice is shown in parentheses, e.g.: 

recursive: Yes (No) 

To send the output to another program, you may enter a vertical bar in 
the "output:" field of the commands' menu. 

When the menu is filled in, press RETURN to start the command. 



Main Menu Commands 

The following menu options are available from the standard main 
menu. Certain sub-commands are available under the Options selec- 
tion. These are described in the next section. 

Copy 

Copy a file to a new file. Copy the contents of a directory to a new 
directory. 

Delete 

Delete a file or directory. 

Edit 

Invoke an editor for a file. Default is the visual editor vi(C). 
Help 

Get help on diverse topics. A menu is displayed at the bottom of 
the screen of available help topics. 

Mail 

Send or read XENDC mail. 
Name 

Rename a directory or file. 
Options 

Perform various commands. See OPTIONS section. 
Print 

Print file or files on systems' lineprinter. 
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Quit 

Quit the visual shell. 
Run 

Run a specified XENIX command or applications program. 
View 

View a specified file or directory listing. This file or directory list- 
ing will be displayed in the upper window. Use the vsh scrolling 
commands to move around (see KEY COMMANDS Section). 

Window 

Reset upper window 'redraw' characteristics and height. 



Options Subcommand 

The Options selection on the main menu has several important com- 
mands grouped under the selections Directory, Filesystem, Output, 
and Permissions. These are as follows: 



Directory 

Make 

Make a directory under current working directory. 
Usage 

Display disk usage by number of blocks in current working direc- 
tory. 



Filesystem 

Create 

Create a filesystem. 

FilesCheck 

Check file system consistency. 

Mount 

Mount a file system on a specified mount-point. 
SpaceFree 

Report number of disk blocks available on all or some mounted file 
systems. 

Unmount 

Unmount specified file system if it is not currently busy. 
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Output 

VShell 

Echo vsh commands in output window (default). 
XENIX 

Echo actual XENIX commands in output window. For instance, if 
running "Options Filesystem FilesCheck", the command fsck will 
be displayed in the output window if "Options Output Xenix" is 
set. 



Permissions 

Change permissions on a file or directory. 



Key Commands 

The following keyboard commands allow editing of menus and fields, 
and give access to various vsh features. 



<Ctrl-E> 

Move the cursor up one line. 

<Ctrl-X> 

Move the cursor down one line. 

<Ctrl-S> 

Move the cursor left one character. 

<Ctrl-D> 

Move the cursor right one character. 

<Ctrl-RxCtrl-E> 
Scroll page up. 

<Ctrl-RxCtrl-X> 
Scroll page down. 

<Ctrl-RxCtrl-S> 
Scroll page left. 

<Ctrl-RxCtrl-D> 
Scroll page right. 

<Ctrl-Q> 

Home. Go to start of menu. 
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<Ctrl-Z> 

End. Go to the end of menu. 

<Ctrl-C> 

Cancel. Stop present operation and return to the main command 
menu. 

<RETURN> 

Start the present command. 

<TAB>, <Ctrl-I>, or <Ctrl-A> 

Move to and select entire contents of next field in command line. 

<SPACE> 

Select next item in menu. 

<BACKSPACE> or <Ctrl-H> 

Select previous menu item. In editing command lists, deletes char- 
acter. Replacement text may then be typed. 

<Ctrl-Y> or <DEL> 

Delete selected character. 

<Ctrl-L> 

Move to next character to right of current cursor position. 
<Ctrl-K> 

Move to next character to left of current cursor position. 
<Ctrl-P> 

Move to next word to right of current cursor position. 
<Ctrl-0> 

Move to next word to left of current cursor position. 

? Help. Request information about the selected command or com- 
mand in progress at the time of the request. 

= Show. Display sub-directory listings and text files in directory list- 
ings. Display submenus for commands in main menu. 

- Goaway. Return listing window to current or parent directory after 
a show command. 

@ Display the Modify menu. 

! Redraw the screen. 

I Display filter menu. 
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Files 



menu.def 



standard menu definition file. 



.mnu 



extension for customized command 



menus. 



/usr/lib/vsh/VSHELL.HPP 



help file 



/usr/lib/vsh/V SHELL.HPT 



yet another help file 



Notes 



The use of wildcard characters (*, [,], and ?) to specify file names is 
not supported by vsh. (Wildcard characters are discussed in the XENIX 
Tutorial.) 

The swtch character is reset by vsh. It is not possible to switch to the 
session manager, shl(C), while running vsh. 

It is necessary to run vsh as superuser and select "help" in order to 
initialize the help files. If this is not done, help is not available. 
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Name 

w - Displays information about who is on the system and what they 
are doing. 



Syntax 

w [-hlqtw] [-n namelist] [-s swapdev] [-c corefile] [-u utmpfile] 
[users...] 



Description 

w prints a summary of the current activity on the system, including 
what each user is doing. The heading line shows the current time of 
day, how long the system has been up, and the number of users logged 
onto the system. On systems that maintain the necessary data, the 
heading line also shows load averages. Load averages are the number 
of processes in the run queue averaged over 1,5, and 15 minutes. 

The options are: 

-h Don't print the heading or title lines. 
-1 

Long format (default): For each user, w outputs the user's login 
name, the terminal or pseudo terminal the user is currently using, 
when the user logged onto the system, the number of minutes the 
user has been idle (how much time has expired since the user last 
typed anything), the CPU time used by all processes and their chil- 
dren attached to the terminal, the CPU time used by the currently 
active process, and the name and arguments of the currently active 
process. 

-q Quick format: For each user, w outputs the user's login name, the 
terminal or pseudo terminal the user is currently using, the number 
of minutes the user has been idle, and the name of the currently 
active process. 

-t 

Only the heading line is output (equivalent to uptime(C)). 
-w Both the heading line and the summary of users is output, 
-n namelist 

The argument is taken as the name of an alternate namelist 
( I xenix is the default). 

-s swapdev 

Uses the file swapdev in place of Idevlswap. This is useful when 
examining a corefile . 
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-ccorefile 

Uses the file corefile in place of Idevlkmem . 
-VLutmpfile 

The file utmpfile is used instead of letclutmp as a record of who is 
currently logged in. 

If any users are given, the user summary is restricted to reporting on 
those users. 



Files 

/xenix 
/etc/utmp 
/dev/kmem 
/dev/swap 



See Also 

date(C), finger(C), ps(C),uptime(C), who(C), whodo(C) 



Notes 

The "currently active process" is only an approximation and is not 
always correct. Pipelines can produce strange results, as can some 
background processes. If w is completely unable to guess at the 
currently active process, it prints 
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Name 

wait - Awaits completion of background processes. 

Syntax 
wait 

Description 

Waits until all background processes started with an ampersand (&) 
have finished, and reports on abnormal terminations. 

Because the wait(S) system call must be executed in the parent pro- 
cess, the shell itself executes wait, without creating a new process. 

See Also 

sh(C) 

Notes 

Not all the processes of a pipeline with three or more stages are chil- 
dren of the shell, and thus cannot be waited for. 
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Name 

wc - Counts lines, words and characters. 



Syntax 

wc [ -lwc ] [ names ] 



Description 

wc counts lines, words and characters in the named files, or in the 
standard input if no names appear. It also keeps a total count for all 
named files. A word is a maximal string of characters delimited by 
spaces, tabs, or newlines. 

The options 1, w, and c may be used in any combination to specify that 
a subset of lines, words, and characters are to be reported. The default 
is -lwc. 

When names are specified on the command line, they are printed 
along with the counts. 
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Name 

what - Identifies files. 



Syntax 
what files 



Description 

what searches the given files for all occurrences of the pattern @(#) 
and prints out what follows until the first tilde ( " ), greater-than sign 
( > ), new-line, backslash ( \ ) or null character. The SCCS command 
get (CP) substitutes this string as part of the @(#) string. 

For example, if the shell procedure in file print contains 

# @(#)this is the print program 

# @(#)syntax: print [files] 
pr $* I lpr 

then the command 

what print 

displays the name of the file print and the identifying strings in that 
file: 

print: 

this is the print program 
syntax: print [files] 

what is intended to be used with the get (CP) command, which 
automatically inserts identifying information, but it can also be used 
where the information is inserted manually. 



See Also 

admin(CP), get(CP) 
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Name 

who - Lists who is on the system. 



Syntax 

who [-uTHldtasq] [file] 
who am i 
who am I 



Description 

who can list the user's name, terminal line, login time, and the elapsed 
time since activity occurred on the line; it also lists the process ID of 
the command interpreter (shell) for each current XENIX system user. 
It examines the /etc/utmp file to obtain its information. If file is 
given, that file is examined. Usually, file will be /etc/wtmp, which 
contains a history of all the logins since the file was last created. 

who with the am i or am I option identifies the invoking user. 

Except for the default -s option, the general format for output entries 
is: 

name [state] line time activity pid [comment] [exit] 

With options, who can list logins, logoffs, reboots, and changes to the 
system clock, as well as other processes spawned by the init process. 
These options are: 

-u This option lists only those users who are currently logged in. 
The name is the user's login name. The line is the name of the 
line as found in the directory /dev. The time is the time that 
the user logged in. The activity is the number of hours and 
minutes since activity last occurred on that particular line. A 
dot (.) indicates that the terminal has seen activity in the last 
minute and is therefore "current". If more than twenty-four 
hours have elapsed or the line has not been used since boot 
time, the entry is marked old. This field is useful when trying 
to determine whether a person is working at the terminal or 
not. The pid is the process ID of the user's shell. The comment 
is the comment field. It can contain information about where 
the terminal is located, the telephone number of the dataset, 
the type of terminal if hard-wired, etc. 

-T This option is the same as the -u option, except that the state of 
the terminal line is printed. The state describes whether some- 
one else can write to that terminal. A plus character (+) 
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appears if the terminal is writable by anyone; a minus charac- 
ter (-) appears if it is not. Root can write to all lines having a 
plus character (+) or a minus character (-) in the state field. If 
a bad line is encountered, a question mark (?) is displayed. 

-1 This option lists only those lines on which the system is wait- 
ing for someone to login. The name field is LOGIN in such 
cases. Other fields are the same as for user entries except that 
the state field does not exist. 

-H This option displays column headings above the regular output. 

-q This is a quick who, displaying only the names and the number 
of users currently logged on. When this option is used, all 
other options are ignored. 

-d This option displays all processes that have expired and have 
not been respawned by init. The exit field appears for dead 
processes and contains the termination, and exit values (as 
returned by wait(S)), of the dead process. This can be useful in 
determining why a process terminated. 

-t This option indicates the last change to the system clock (via 
the date(C) command) by root. See su(C). 

-a This option processes the /etc/utmp file or the named file with 
all options turned on. 

-s This option is the default and lists only the name, line, and 
time fields. 



Files 

/etc/utmp 
/etc/wtmp 
/etc/inittab 



See Also 

date(C), login(M), mesg(C), su(C), utmp(F), inittab(F), wait(S) 



Notes 

The options -A, -b, -p, and -r are listed in the usage message and are 
accepted as legal options by who but do not do anything. 
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whodo - Determines who is doing what. 



WHODO (C) 



Syntax 

/etc/whodo 

Description 

whodo produces merged, reformatted, and dated output from the 
who(C) and ps(C) commands. 

See Also 

ps(C), who(C) 
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Name 

write - Writes to another user. 



Syntax 

write user [ tty ] 



Description 

write copies lines from your terminal to that of another user. When 
first called, it sends the message: 

Message from your-logname your-tty . . . 

The recipient of the message should write back at this point. Com- 
munication continues until an end-of-file is read from the terminal or 
an interrupt is sent. At that point, write displays: 

(end of message) 

on the other terminal and exits. 

If you want to write to a user who is logged in more than once, the tty 
argument may be used to indicate the appropriate terminal. 

Permission to write may be denied or granted by use of the mesg(C) 
command. At the outset, writing is allowed. Certain commands, in 
particular nroff{CT) and pr(C), disallow messages in order to prevent 
messy output. 

If the character ! is found at the beginning of a line, write calls the 
shell to execute the rest of the line as a command. 

The following protocol is suggested for using write : when you first 
write to another user, wait for him or her to write back before starting 
to send. Each party should end each message with a distinctive signal 
((o) for "over" is conventional), indicating that the other may reply; 
(oo) for "over and out" is suggested when conversation is to be ter- 
minated. 
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Files 

/etc/utmp To find user 

/bin/sh To execute ! 



See Also 

mail(C), mesg(C), who(C) 
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Name 

xargs - Constructs and executes commands. 



Syntax 

xargs [ flags ] [ command [ initial-arguments ] ] 



Description 

xargs combines the fixed initial-arguments with arguments read from 
the standard input to execute the specified command one or more 
times. The number of arguments read for each command invocation 
and the manner in which they are combined are determined by the 
flags specified. 

Command, which may be a shell file, is searched for using the shell 
$PATH variable. If command is omitted, /bin/echo is used. 

Arguments read in from standard input are defined to be contiguous 
strings of characters delimited by one or more blanks, tabs, or new- 
lines; empty lines are always discarded. Blanks and tabs may be 
embedded as part of an argument if escaped or quoted: Characters 
enclosed in quotes (single or double) are taken literally, and the del- 
imiting quotes are removed. Outside of quoted strings, a backslash (\) 
will escape the next character. 

Each argument list is constructed starting with the initial-arguments , 
followed by some number of arguments read from standard input 
(exception: see -i flag). Flags -i, -1, and -n determine how arguments 
are selected for each command invocation. When none of these flags 
are coded, the initial-arguments are followed by arguments read con- 
tinuously from standard input until an internal buffer is full, and com- 
mand is executed with the accumulated args. This process is repeated 
until there are no more args. When there are flag conflicts (e.g., -1 vs. 
-n), the last flag has precedence. Flag values are: 

-Inumber Command is executed for each number lines of 
nonempty arguments from the standard input. This is 
instead of the default single line of input for each com- 
mand. The last invocation of command will be with 
fewer lines of arguments if fewer than number remain. 
A line is considered to end with the first newline unless 
the last character of the line is a blank or a tab; a trail- 
ing blank/tab signals continuation through the next 
nonempty line. If number is omitted, 1 is assumed. 
Option -x is forced. 
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-ireplstr Insert mode: command is executed for each line from 
the standard input, taking the entire line as a single arg, 
inserting it in initial-arguments for each occurrence of 
replstr. A maximum of 5 arguments in initial- 
arguments may each contain one or more instances of 
replstr. Blanks and tabs at the beginning of each line 
are thrown away. Constructed arguments may not grow 
larger than 255 characters, and option -x is also forced. 
{ } is assumed for replstr if not specified. 

-xmumber Executes command , using as many standard input 
arguments as possible, up to the number of arguments 
maximum. Fewer arguments are used if their total size 
is greater than size characters, and for the last invoca- 
tion if there are fewer than number arguments remain- 
ing. If option -x is also coded, each number of argu- 
ments must fit in the size limitation, or xargs ter- 
minates execution. 

-t Trace mode: The command and each constructed argu- 

ment list are echoed to file descriptor 2 just prior to 
their execution. 

-p Prompt mode: The user is prompted whether to execute 

command at each invocation. Trace mode (-t) is turned 
on to display the command instance to be executed, fol- 
lowed by a ?. . . prompt. A reply of y (optionally fol- 
lowed by anything), will execute the command; any- 
thing else, including a carriage return, skips that partic- 
ular invocation of command. 

-x Causes xargs to terminate if any argument list would 

be greater than size characters; -x is forced by the 
options -i and -1. When neither of the options -i, -I, or 
-n are coded, the total length of all arguments must be 
within the size limit. 

-ssize The maximum total size of each argument list is set to 

size characters; size must be a positive integer less than 
or equal to 470. If -s is not coded, 470 is taken as the 
default. Note that the character count for size includes 
one extra character for each argument and the count of 
characters in the command name. 

-eeofstr Eofstr is taken as the logical end-of-file string. Under- 
score ( _ ) is assumed for the logical EOF string if -e is 
not coded, -e with no eofstr coded turns off the logical 
EOF string capability (underscore is taken literally). 
xargs reads standard input until either end-of-file or the 
logical EOF string is encountered. 
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xargs terminates if it either receives a return code of -1 from, or if it 
cannot execute, command. When command is a shell program, it 
should explicitly exit (see sh(C)) with an appropriate value to avoid 
accidentally returning with -1. 



Examples 

The following will move all files from directory $1 to directory $2, 
and echo each move command just before doing it: 

Is $1 I xargs -i -t mv $l/{ } $2/{ } 

The following will combine the output of the parenthesized com- 
mands onto one line, which is then echoed to the end of file log: 

(logname; date; echo $0 $*) I xargs »log 

The user is prompted to enter which files in the current directory are to 
be printed and prints them one at a time: 

Is I xargs -p -1 lpr 

Or many at a time: 

Is I xargs -p -1 I xargs lpr 

The following will execute diff(C) with successive pairs of arguments 
originally entered as shell arguments: 

echo $* I xargs -n2 diff 
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Name 

yes - Prints string repeatedly. 



Syntax 

yes [ string ] 



Description 

yes repeatedly outputs "y", or if a single string argument is given, arg 
is output repeatedly. The command will continue indefinitely unless 
aborted. Useful in pipes to commands that prompt for input and 
require a "y" response for a yes. In this case, yes terminates when 
the command it pipes to terminates, so that no infinite loop occurs. 
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Name 

intro - Introduction to miscellaneous features and files. 
Description 

This section contains miscellaneous information useful in maintaining 
the system. Included are descriptions of files, devices, tables and pro- 
grams that are important in maintaining the entire system. 
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Name 

aliases, aliases.hash, maliases, maliases.hash, faliases - Micnet alias- 
ing files. 



Description 

These files contain the alias definitions for a Micnet network. Aliases 
are short names or abbreviations that may be used in the mail com- 
mand to refer to specific machines or users in a network. Aliasing 
allows a complex combination of site, machine, and user names to be 
represented by a single name. 

The aliases, maliases, and faliases files each define a different type of 
alias. The aliases file defines the standard aliases which are names 
for specific systems and users and, in some case, for commands. The 
maliases file defines machine aliases, names, and paths for specific 
systems. The faliases file defines forwarding aliases which are tem- 
porary names for forwarding mail intended for one system or user to 
another. 

The aliases.hash file is the hashed version of the aliases file created 
by the aliashash command. The file is used by the mail command to 
resolve all standard aliases and is identical to the aliases file except 
for a hash table at the beginning of the file. The hash table allows for 
more efficient access to the entries in the file. The aliases file need 
only be present to generate the aliases.hash file. The aliases file is 
not required to run the network. 

The maliases.hash file is the hashed version of the maliases file. It is 
an optional file created by executing the following command: 

/usr/lib/mail/aliashash /usr/lib/mail/maliases 

If the maliases.hash file is created, maliases is no longer necessary to 
run the network. If the number of machines in the network is large, 
and particularly if several types of networks are in use, it is recom- 
mended that the maliases file be hashed. In such a network, the 
configuration is no longer homogeneous, aliases are likely to be fairly 
complex and machine aliases are likely to differ between machines. 
The use of machine aliases allows the standard alias file to be identi- 
cal on all machines in the network. In such an environment, netutil 
can only generate network files that can be used as a starting point. 
The rest of the network maintenance should be done manually with a 
text editor. 

Each file contains zero or more lines. If hashing is to be performed, at 
least one alias is required. Each line lists the alias and its meaning. 
The alias meaning can have site, machine, and user login names and 
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other aliases (its exact composition depends on the type of alias). A 
colon (:) separating the alias and meaning is required. 

In the aliases file, a line can have the forms: 

alias:[ [site!]machine:]user[,[ [site!]machine:]user]. .. 

alias: [ [site!]machine:]command-pipeline 

alias :error-message 

Site and machine are the site and machine names of the system to 
which the user belongs or on which the specified command is to be 
executed. The site and machine names must end with an exclamation 
mark (!) or colon (:) respectively, and must be defined in a systemid 
file. A machine alias may be used in place of a site and machine name 
if it is followed by a question mark. 

User is a user login name or another alias. User names in a list must 
be separated by commas. A newline may immediately follow a 
comma. Spaces and tabs are allowed, but only immediately before or 
after a comma or newline. 

Command-pipeline is any valid command (with necessary arguments) 
preceded by a pipe symbol (\) and enclosed in double quotation marks. 
Spaces may separate the command and arguments, but there must be 
no space between the first double quotation mark and the pipe symbol. 

Error-message is any sequence of letters, numbers, and punctuation 
marks (except a double quotation mark), preceded by a number sign 
(#) and enclosed in double quotation marks. 

In the faliases file, each line can have the same form as lines in the 
aliases file except that no more than one user name can be given for 
any one alias. To prevent alias expansion on a remote machine, the 
meaning should be escaped with ' '\V ', as in: 

foo: mach?\\foo 

Failure to do the escape may result in an infinite forwarding loop. If 
this happens and the loop does not invoke a uucp connection, looping 
will be detected, and the mail will be returned to the sender. 

The alias.hash file has already been searched at this point. If there is 
no explicit machine given as part of the meaning, the recipient will be 
assumed to be local. After forward aliasing is complete, machine 
aliasing is performed as necessary. 
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In the maliases file, a line has the form: 

alias :[ [site !]machine:]. .. 

Site and machine are the site and machine names for a specific net- 
work and system. Multiple site and machine names direct messages 
along the specified path of systems. If no site or machine name is 
given, the alias is ignored. 

Before the mail program sends a message, it searches the aliases.hash, 
faliases, and maliases files to see if any of the names given with the 
command are aliases. Each file is searched in turn (aliases.hash, 
faliases, then maliases) and if a match is found, the alias is replaced 
with its meaning. If no match is found, the name is assumed to be the 
valid login name of a user on that machine. The search in the 
aliases.hash file continues until all aliases have been replaced, so it is 
possible for several replacements to occur for a single name. Alias 
loops are now detected. If a loop exists, any recipients involved in the 
alias loop are dropped from the mail recipient list, and an error mes- 
sage is displayed. The faliases file is searched once, from beginning 
to end, even if it is empty. The maliases file is searched only if the 
alias contains a machine alias. 

When an alias is a user or a list of users, the mail command sends the 
message to each user in the list. When it is a command-pipeline, the 
mail command starts execution of the command on the specified 
machine and sends the message as input. When the alias is an error- 
message, the mail command ignores the message and instead, displays 
the alias and its meaning at the standard error. 

In all files, any line beginning with a number sign (#) is considered a 
comment and is ignored. 

As a special feature, any alias that contains a site name as the first 
component of its meaning is automatically prepended with the 
machine alias uucp?. This alias may be explicitly defined in the 
maliases file to help direct mail between networks to the system per- 
forming the uucp link. 



Directives 

Though alias directives are never included in an alias expansion, they 
can be used to restrict the expansion to a class of users, forward the 
unexpanded alias to another machine, or produce error messages. An 
aliases file may include directives of the form: 

testalias: $xalaska, mikem, georger, terih 

sams: "$e ambiguous, use samst or samsm" 
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Fields on the right-hand side of an alias (after the colon) that begin 
with a dollar sign ($) character, are alias directives. Fields containing 
any blanks or tabs must be enclosed in quotes. The directive must pre- 
cede all normal right-hand fields as shown in the example above. The 
character following the dollar sign ($) specifies the directive type: 

$n <real name or description> 

$x <machine> 

$e <error message> 

$p <permissions> 

$r <restrictions> 

None of the above directives are currently supported in 
/usr/Iib/mail/faliases. Only the $e is supported in 
/usr/lib/mail/maliases and maliases.hash. Unrecognized directives 
do not create error messages and are treated as if they do not exist. 
The above directives are described in detail as follows: 

$n For a user alias, this field should contain the full real name of the 
user associated with the alias. For a group alias, a description of 
the group should be given. 

$x Causes the alias to be forwarded, unexpanded, to the machine 
specified in this field. White space is only allowed immediately 
following the $x. Since machine aliasing will be performed, the 
appropriate machine alias must exist in the maliases file. 

$e This field contains an error message to be printed. The left side of 
the alias will be removed from the list of users to be aliased. An 
alternate form of $e is #. 

$p This field contains the character star (*) or a string of upper and 
lowercase alphabetic characters. Each character indicates that the 
user on the left-hand side of the alias belongs to a special "class" 
of users. The star (*) character implies membership in all such 
classes. 

$r This field contains a string of upper and lower case alphabetic 
characters, each character indicating a "class" of users to be 
granted expansion permision. The absence of a $r field means that 
any user can expand the alias. If the $r field exists, expansion is 
only allowed if: 

1) the user requesting expansion has a $p field and it contains one or 
more of the characters found in the $r field. 
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2) the user has a $p field and it contains a 

3) the real user ID is (super user). 

If expansion is not allowed, no error messages result; the alias in ques- 
tion is treated as if it were not present. 

To send mail delivery problems to root, the following alias could be 
used: 

network: "$n the network mail recipient," root 

To forward a group alias called testalias to a machine called alaska 
and expand it there, the following alias may be used: 

testalias: $xalaska, mikem, georger, terih 

Files 

/usr/lib/mail/aliases \ 

/usr/lib/mail/aliases.hash 

/usr/lib/mail/maliases 

/usr/lib/mail/faliases 

/usrAib/mail/maliases.hash 

See Also 

aliashash(ADM), netutil(ADM), systemid(F), top(F) 
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Name 

ascii - Map of the ASCII character set. 
Description 



ascii is a map of the 7-bit ASCII character set. It lists both octal and 
hexadecimal equivalents of each character. It contains: 



Octal 


000 


nul 


001 


soh 


002 


stx 


003 


etx 


004 


eot 


005 


enq 


006 


ack 


007 


bel 


010 


bs 


011 


ht 


012 


nl 


013 


vt 


014 


np 


015 


cr 


016 


so 


017 


si 


020 


die 


021 


del 


022 


dc2 


023 


dc3 


024 


dc4 


025 


nak 


026 


syn 


027 


etb 


030 


can 


031 


em 


032 


sub 


033 


esc 


034 


fs 


035 


gs 


036 


rs 


037 


us 


040 


sp 


041 


i 


042 




043 


# 


044 


$ 


045 


% 


046 


& 


047 




050 


( 


051 


) 


052 


* 


053 


+ 


054 




055 




056 




057 


/ 


060 





061 


1 


062 


2 


063 


3 


064 


4 


065 


5 


066 


6 


067 


7 


070 


8 


071 


9 


072 




073 




074 


< 


075 




076 


> 


077 


? 


100 


@ 


101 


A 


102 


B 


103 


C 


104 


D 


105 


E 


106 


F 


107 


G 


110 


H 


111 


I 


112 


J 


113 


K 


114 


L 


115 


M 


116 


N 


117 


O 


120 


P 


121 


Q 


122 


R 


123 


S 


124 


T 


125 


U 


126 


V 


127 


W 


130 


X 


131 


Y 


132 


Z 


133 


[ 


134 


\ 


135 


] 


136 




137 




140 




141 


a 


142 


b 


143 


c 


144 


d 


145 


e 


146 


f 


147 


g 


150 


h 


151 


i 


152 


J 


153 


k 


154 


1 


155 


m 


156 


n 


157 


o 


160 


P 


161 


q 


162 


r 


163 


s 


164 


t 


165 


u 


166 


V 


167 


w 


170 


X 


171 


y 


172 


z 


173 


{ 


174 


1 


175 


} 


176 




177 


del 



Hexadecimal 


00 


nul 


01 


soh 


02 


stx 


03 


etx 


04 


eot 


05 


enq 


06 


ack 


07 


bel 


08 


bs 


09 


ht 


0a 


nl 


0b 


vt 


0c 


np 


Od 


cr 


Oe 


so 


Of 


si 


10 


die 


11 


del 


12 


dc2 


13 


dc3 


14 


dc4 


15 


nak 


16 


syn 


17 


etb 


18 


can 


19 


em 


la 


sub 


lb 


esc 


lc 


fs 


Id 


gs 


le 


rs 


If 


us 


20 


sp 


21 


1 


22 




23 


# 


24 


$ 


25 


% 


26 


& 


27 




28 


( 


29 


) 


2a 


* 


2b 


+ 


2c 




2d 




2e 




2f 


/ 


30 





31 


1 


32 


2 


33 


3 


34 


4 


35 


5 


36 


6 


37 


7 


38 


8 


39 


9 


3a 




3b 




3c 


< 


3d 




3e 


> 


3f 


? 


40 


@ 


41 


A 


42 


B 


43 


C 


44 


D 


45 


E 


46 


F 


47 


G 


48 


H 


49 


I 


4a 


J 


4b 


K 


4c 


L 


4d 


M 


4e 


N 


4f 


O 


50 


P 


51 


Q 


52 


R 


53 


S 


54 


T 


55 


U 


56 


V 


57 


W 


58 


X 


59 


Y 


5a 


Z 


5b 


[ 


5c 


\ 


5d 


] 


5e 




5f 




60 




61 


a 


62 


b 


63 


c 


64 


d 


65 


e 


66 


f 


67 


g 


68 


h 


69 


i 


6a 


j 


6b 


k 


6c 


1 


6d 


m 


6e 


n 


6f 





70 


P 


71 


q 


72 


r 


73 


s 


74 


t 


75 


u 


76 


V 


77 


w 


78 


x 


79 


y 


7a 


z 


7b 


{ 


7c 


1 


7d 


} 


7e 




7f 


del 
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The extended 8-bit ASCII character set is shown here, again with the 
octal and hexadecimal value of each character. The mapchan(C) util- 
ity allows access to these characters. Display of these characters is 
dependent on the capabilities of the hardware device. (A indicates 
an unassigned character.) 



Octal 


200 




201 




202 


S; 


203 


s:; 


204 


ind 


205 


nel 


206 


ssa 


207 esa 


210 


hts 


211 


htj 


212 


vts 


213 


pld 


214 


plu 


215 


ri 


216 


ss2 


217 ss3 


220 


dcs 


221 


pul 


222 


pu2 


223 


sts 


224 


cch 


225 


mw 


226 


spa 


227 epa 


230 


m 


231 


m 


232 


m 


233 


csi 


234 


St 


235 


osc 


236 


pm 


237 ape 


240 


nbsp 


241 


i 


242 





243 


£ 


244 


D 


245 


¥ 


246 


1 


247 § 


250 




251 


© 


252 




253 


« 


254 




255 


shy 


256 


® 


257 


260 




261 


± 


262 


2 


263 


3 


264 




265 




266 


H 


267 • 


270 




271 


i 


272 




273 


» 


274 


Va 


275 




276 


Va 


277 i 


300 


A 


301 


A 


302 


A 


303 


A 


304 


A 


305 


A 


306 


JE 


307 Q 


310 


E 


311 


E 


312 


E 


313 


E 


314 


i 


315 


f 


316 


I 


317 I 


320 


D 


321 


N 


322 


6 


323 


6 


324 


6 


325 


6 


326 


O 


327 & 


330 





331 


U 


332 


u 


333 


u 


334 


u 


335 


Y 


336 


P 


337 6 


340 


a 


341 


& 


342 


a 


343 


a 


344 


a 


345 


ae 


346 


ae 


347 ? 


350 


e 


351 


e 


352 


e 


353 


e 


354 


i 


355 


f 


356 


i 


357 i 


360 


d 


361 


n 


362 


6 


363 


d 


364 


6 


365 


6 


366 


6 


367 & 


370 





371 


u 


372 


u 


373 


u 


374 


ii 


375 


y 


376 


b 


377 y 



Hexadecimal 


80 




81 




82 


m 


83 




84 ind 


85 


nel 


86 


ssa 


87 esa 


88 


hts 


89 


htj 


8a 


vts 


8b 


pld 


8c plu 


8d 


ri 


8e 


ss2 


8f ss3 


90 


dcs 


91 


pul 


92 


pu2 


93 


sts 


94 cch 


95 


mw 


96 


spa 


97 epa 


98 


m 


99 




9a 




9b 


csi 


9c st 


9d 


osc 


9e 


pm 


9f ape 


aO 


nbsp 


al 


i 


a2 




a3 


£ 


a4 a 


a5 


¥ 


a6 


1 


a7 § 


a8 




a9 


© 


aa 




ab 


« 


ac —i 


ad 


shy 


ae 


® 


af 


bO 


o 


bl 


± 


b2 


2 


b3 


3 


b4 ' 


b5 




b6 


H 


b7 • 


b8 




b9 


i 


ba 




bb 


» 


be Va 


bd 


Vi 


be 


Va 


bf l 


cO 


A 


cl 


A 


c2 


A 


c3 


A 


c4 A 


c5 


A 


c6 


JE 


cl C 


c8 


E 


c9 


E 


ca 


e 


cb 


E 


cc i 


cd 


f 


ce 


I 


cf I 


dO 


D 


dl 


N 


d2 


6 


d3 


6 


d4 6 


d5 





d6 





d7 & 


d8 





d9 


tf 


da 


u 


db 


u 


dc U 


dd 


Y 


de 


I> 


df 6 


eO 


a 


el 


a 


e2 


a 


e3 


a 


e4 a 


e5 


a 


e6 


32 


e7 q 


e8 


e 


e9 


6 


ea 


e 


eb 


e 


ec i 


ed 


f 


ee 


1 


ef i 


fO 


d 


fl 


h 


f2 


6 


f3 


6 


f4 6 


f5 


6 


f6 


6 


f7 ^ 


f8 





f9 


u 


fa 


u 


fb 


u 


fc ii 


fd 


y 


fe 


b 


ff y 



Files 

/usr/pub/ascii 
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Name 

coffconv - Convert 386 COFF files to XENIX format. 



Syntax 

coffconv [ -v ] [ -o outfile ] coff-file 



Description 

coffconv converts 386 Common Object Format Files (COFF) to the 
appropriate Xenix file format. If the file specified is a relocatable 
object module it is converted to Microsoft OMF format. If it is an 
executable binary it is converted to x.out format. 

If the file is a UNIX System V archive, it is converted to XENIX 
archive format and each file in the archive is converted as appropriate. 
Any files in the archive which are not in 386 COFF format are copied 
to the new archive unchanged, coffconv also creates a XENIX format 
.SYMDEF symbol directory for the new archive. 

Options are: 

-v Verbose mode. The name of each member of an archive is 
displayed as it is converted. 

-o Output file name. If no output file name is specified the default 
is x.out. 



Notes 

Only essential symbol table information is converted. Source line 
numbers and additional symbol information for use by the symbolic 
debugger sdb will be ignored. 

Note that coffconv only converts 386 COFF files. It is not possible to 
convert 286 COFF files. 



Files 

x.out Default output file 



See Also 

86rel(F), a.out(F), ar(F) 
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Name 

console - System console device. 



Description 

The file /dev/console is the device used by the system administrator 
for system maintenance (single-user) operations. It is the tty to which 
the first default shell is attached. 

The system console device can be either a terminal (a serial adapter 
device, tty la) or a sytem keyboard display adapter monitor (ttyOl). 

Many programs, such as the XENIX kernel, redirect error messages to 
/dev/console. Initially /dev/console is linked to /dev/systty. 



Files 

/dev/console 



See Also 

boot(HW), systty(M), tty(M) 



Notes 

/dev/console should not be enabled, instead either the the display 
adapter (ttyOl) or the serial adapter device (ttyla) should be enabled. 

A serial console cannot be attached to a multiport card or one that 
uses special drivers; it must be on a standard COM1 card. 

In any console escape sequence, the caret character Q will have 32 
(decimal) subtracted from the ASCII value and will be interpreted as 
the right angle bracket or "greater than" key. 
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Name 

daemon.mn - Micnet mailer daemon 



Syntax 

/usr/lib/mail/daemon.mn [-ex] 



Description 

The mailer daemon performs the "backend" networking functions of 
the mail, rep, and remote commands by establishing and servicing the 
serial communication link between computers in a Micnet network. 

When invoked, the daemon creates multiple copies of itself, one copy 
for each serial line used in the network. Each copy opens the serial 
line, creates a startup message for the LOG file, and waits for a 
response from the daemon at the other end. The startup message lists 
the names of the machines to be connected, the serial line to be used, 
and the current date and time. If the daemon receives a correct 
response, it establishes the serial link and adds the message "first 
handshake complete" to the LOG file. If there is no response, the dae- 
mon waits indefinitely. 

If invoked with the -x switch, the daemon records each transmission in 
the LOG file. A transmission entry shows the direction of the 
transmission (tx for transmit, rx for receive), the number of bytes 
transmitted, the elasped time for the transmission (in minutes and 
seconds), and the time of day of the transmission (in hours, minutes, 
and seconds). Each entry has the form: 

direction byte_count elasped Jime time_of_day 

The daemon also records the date and time every hour. The date and 
time have the same format as described for the date command. 

If invoked with the -e switch, the daemon records all transmission 
errors in the LOG file. An error entry shows the cause of the error pre- 
ceded by the name of the daemon subroutine which detected the error. 

The mailer daemon is normally invoked by the start option of the 
netutil command and is stopped by the stop option. 

During the normal course of execution, the mailer daemon uses 
several files in the /usr/spool/micnet/remote directory. These files 
provide storage for LOG entries, commands issued by the remote (C) 
command, and a list of processes under daemon control. 
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Files 

/usr/lib/mail/ daemon.mn 

/usr/spool/micnet/remote/*/LOG 

/usr/spool/micnet/remote/*/mn 

/usr/spool/micnet/remoteAocal/mn* 

/usr/spool/micnet/remote/lock 

/usr/spool/micnet/remote/pids 

See Also 

netutil(ADM) 
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Name 

environ - The user environment. 



Description 

The user environment is a collection of information about a user, such 
as his login directory, mailbox, and terminal type. The environment is 
stored in special "environment variables," which can be assigned 
character values, such as names of files, directories, and terminals. 
These variables are automatically made available to programs and 
commands invoked by the user. The commands can then use the 
values to access the user's files and terminal. 

The following is a short list of commonly used environment variables. 



PATH 



HOME 



EXINIT 



TERM 



Defines the search path for the directories containing 
commands. The system searches these directories 
whenever a user types a command without giving a full 
pathname. The search path is one or more directory 
names separated by colons (:). Initially, PATH is set to 
:/bin:/usr/bin. 

Names the user's login directory. Initially, HOME is set 
to the login directory given in the user's passwd file 
entry. 

Used to set vi options. For Bourne Shell users the syn- 
tax is: 

EXINIT = 'set options' 

For C-Shell users the syntax is: 

setenv EXINIT 'set options' 

For example, a C-Shell user might place the following 
command in $HOMEI xshrc: 

setenv EXINIT 'set wm=24' 

This would automatically set vi's wrapmargin option to 
24. 

Defines the type of terminal being used. This informa- 
tion is used by commands such as more(C) which rely 
on information about the capabilities of the user's ter- 
minal. The variable may be set to any valid terminal 
name (see terminals (M)) directly or by using the 
tset(C) command. 
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TZ Defines time zone information. This information is used 

by date(C) to display the appropriate time. The vari- 
able may have any value of the form: 

xxxnzzzs; start/time, end/time 

where xxx is standard local time zone abbreviation (1-9 
characters), n is the standard time zone difference from 
GMT, and may be given as hh:mm:ss 
(hours:minutes:seconds), zzz is the summertime local 
time zone abbreviation of 1-9 characters (if any), s is 
the summertime time zone difference from GMT, and 
may be given as hh:mm:ss (hours:minutes:seconds), 
start and end specify the day to begin and end sum- 
mertime based on one of four rules, and time is the 
time of day the change to or from summertime occurs. 
The rules for specifying start and end are: 

Jn 1 based Julian day n 

n based Julian day n 

Wn.d nth day of week d 

Mm.n.d nth day of week d in month m 



For example: 



EST5:00:00EDT4:00:00;M4.1.0/2:00:00,M10.5.0/2:00:00. 
Refer to the tz(M) manual page for more on TZ. 

HZ Defines, with a numerical value, the number of clock 

interrupts per second. The value of this variable is 
dependent on the hardware, and configured in the file 
etc/default/login. If HZ is not defined, programs which 
depend on this hertz value, such as prof(CP) and 
times(S), will not run. 



LANG Defines the language locale a user wishes to use. This 

variable can be queried by applications and utilities to 
determine how to display information, what language 
to use for messages, sorting order, and other language 
dependent functions. 

The environment can be changed by assigning a new value to a vari- 
able. For Bourne shell, sh(C), an assignment has the following format: 



name=value 



For example, the assignment: 



TERM=h29 
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sets the TERM variable to the value "h29". The new value can be 
"exported" to each subsequent invocation of a shell by exporting the 
variable with the export command (see sh (C)) or by using the env(C) 
command. 

C-shell users make assignments using the setenv command. For 
example: 

setenv TERM h29 

For more information, see csh(C). 

A user may also add variables to the environment, but must be sure 
that the new names do not conflict with exported shell variables such 
as MAIL, PS 1, PS2, and IFS. Placing assignments in the .profile file is 
a useful way to change the environment automatically before a session 
begins. C-shell users can place assignments in their .cshrc or .login 
files. 

Note that the environment is made available to all programs as a 
string of arrays. Each string has the format: 

name= value 

where the name is the name of an exported variable and the value is 
the variable's current value. For programs started with a exec(S) call, 
the environment is available through the external pointer environ . For 
other programs, individual variables in environment are available 
through getenv(S) calls. 



See Also 

csh(C), env(C), exec(S), getenv(S), login(M), profile(M), sh(C), tz(M) 
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Name 

error - Kernel error output device. 



Description 

System error messages are collected and made available to error log- 
ging daemons through the /dev/error device, /dev/error is a read- 
only device which returns one error per read and no EOF character, 
/etc/rc uses a utility to read messages from /dev/error and write them 
to the system error log file /usr/adm/messages: 

/etc/logger /dev/error /usr/adm/messages & 

Any process can read /dev/error or arrange to be signaled when errors 
are queued in /dev/error. The following ioctl causes the error device 
to signal the process with SIGUSR1 when an error message is queued 
in /dev/error. 

#include <signal.h> 
#include <syserr.h> 

int fd; 

fd = open(7dev/error", 0_RDONLY); 
ioctl(fd, EMSG_SIG, SIGUSR1); 

Before exiting, the process must return /dev/error to its normal state. 
Do this with the following ioctl: 

ioctl(fd,EMSG_NOSIG, 0); 



Panic error messages are not logged in /dev/error. 



Files 

/dev/error 



See Also 

messages(M) 
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Name 

getty - Sets terminal type, modes, speed, and line discipline. 



Syntax 

/etc/getty [ -h ] [ -t timeout ] line [ speed [ type [ linedisc ] ] ] 
/etc/getty -c file 



Description 

getty is a program that is invoked by init(M). It is the second process 
in the series, (init-getty-login-shell ), that ultimately connects a user 
with the XENIX system. Initially getty displays the login message 
field for the entry it is using from /etc/gettydefs. getty reads the user's 
login name and invokes the login (M) command with the user's name 
as argument. While reading the name, getty attempts to adapt the sys- 
tem to the speed and type of terminal being used. 

Line is the name of a tty line in /etc/ttys to which getty is to attach 
itself, getty uses this string as the name of a file in the /dev directory 
to open for reading and writing. The -t flag, plus timeout in seconds, 
specifies that getty should exit if the open on the line succeeds and no 
one enters anything in the specified number of seconds. The optional 
second argument, speed, is a label to a speed and tty definition in the 
file /etc/gettydefs. This definition tells getty what speed to initially 
run, what the login message should look like, what the initial tty set- 
tings are, and what speed to try next should the user indicate that the 
speed is inappropriate (by entering a BREAK character). The default 
speed is 300 baud. The optional third argument, type, is a character 
string describing to getty what type of terminal is connected to the line 
in question, getty understands the type none — any CRT or normal ter- 
minal unknown to the system. This is the default. 

For terminal type to have any meaning, the virtual terminal handlers 
must be compiled into the operating system. They are available, but 
not compiled in the default condition. The optional fourth argument, 
linedisc , is a character string describing which line discipline to use in 
communicating with the terminal. Again the hooks for line discip- 
lines are available in the operating system but there is only one 
presently available, the default line discipline, LDISCO. 

When given no optional arguments, getty sets the speed of the inter- 
face to 300 baud, specifies that raw mode will be used (awaken on 
every character), that echo will be suppressed, either parity allowed, 
that new-line characters will be converted to carriage return-line feed, 
and that tab expansion is performed on the standard output. It displays 
the login message before reading the user's name a character at a time. 
If a null character (or framing error) is received, it is assumed to be 
the result of the user pushing the BREAK key. This will cause getty to 
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attempt the next speed in the series. The series that getty tries is 
determined by what it finds in /etc/gettydefs. 

The user's name is terminated by a new-line or carriage-return charac- 
ter. The latter results in the system being set to treat carriage returns 
appropriately (see ioctl(S)). 

The user's name is scanned to see if it contains any lower-case alpha- 
betic characters, getty suggests that the user use all lower-case charac- 
ters. If the user uses upper case characters, the system is told to map 
any future upper-case characters into the corresponding lower-case 
characters. 

Finally, the login-program from /etc/gettydefs is called with the user's 
name as an argument. Additional arguments may be entered after the 
login name. These are passed to the login-program. The default 
login-program, /etc/login, places them in the environment (see 
login (M)). 

A check option is provided. When getty is invoked with the -c option 
and file, it scans the file as if it were scanning /etc/gettydefs and 
prints out the results to the standard output. If there are any unrecog- 
nized modes or improperly constructed entries, it reports these. If the 
entries are correct, it displays the values of the various flags. See 
ioctl(S) to interpret the values. Note that some values are added to the 
flags automatically. 



Notes 

Changes have been made to support using the line for uucico, cu, and 
ct; that is, the line can be used in both directions. The getty will allow 
users to login, but if the line is free, uucico, cu, or ct can use it for 
dialing out. The implementation depends on the fact that uucico, cu, 
and ct create lock files when devices are used. When the "open()" 
returns on a modem-control-line (or the first character is read on a 
non-modem-control line), the status of the lock file indicates whether 
the line is being used by uucico, cu, ct, or someone trying to login. 
Note that in the non-modem-control case, several <carriage-return> 
characters may be required before the login message is output. The 
human users will be able to handle this slight inconvenience, uucico 
trying to login will have to be told by using a login script similar to 
the following: 

"" V\dVNd\r\d\r in:~in: ... 

where ... is whatever would normally be used for the login sequence. I 

getty only behaves in this special UUCP mode (waiting for a first 
character, checking for a lock file) if the line is shared between dial-in 
and dial-out (i.e., only if there is an entry for that line in 
/usr/lib/uucp/Devices. If the UUCP package is not installed, then 
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getty will not behave in this manner. If a line is shared between dial- 
in and dial-out and there is a dialer on the line, then getty will reini- 
tialize the line to dial-in prior to opening the the line by running 
dialer -h, where dialer is the dialer program given in the Devices 
entry (see dial(M)), or by running /usr/lib/uucp/uuchat with the reini- 
tialization chat specified by an ampersand (&) entry in 
/usr/Hb/uucp/Dialers. getty generates no error message if this reini- 
tialization fails. 

The -h flag is used when ct invokes getty itself; it instructs getty to 
bypass this special UUCP function, since ct has already opened and 
locked the line. 



Files 

/etc/gettydefs 
/etc/ttys 

/usr/lib/uucp/Devices 
/usr/lib/uucp/Dialers 
/usr/lib/uucp/LCK. .ttyXX 



See Also 

init(M), login(M), ioctl(S), gettydefs(F), ttys(F), ct(C), dial(M), cu(C), 
uucico(ADM). 
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Name 

imagen.sbs, imagen.pbs, imagen.spp, imagen.remote - IMAGEN 
printer interface scripts. 



Syntax 

imagen.sbs request user title copies options files... 
imagen.pbs request user title copies options files... 
imagen.spp request user title copies options files... 
imagen.remote request user title copies options files... 



Description 

The imagen scripts are the XENIX System V spooler interface pro- 
grams for IMAGEN printers. They accept the following types of files 
for printing: troff '(CT) input, troff output (C/A/T format), imPRESS 
format, DVI format (generally produced by ), and straight text. The 
proper imagen interface script is normally installed using 
Ipadmin (ADM). 

imagen.sbs uses the "serial byte stream protocol" provided by isbs. 

imagen.pbs uses the "parallel byte stream protocol' ' provided by ipbs. 

imagen.spp uses the serial "sequence packet protocol" provided by 
ips(ADM). 

imagen.remote sends the print job to a remote computer using either 
uux(C) or remote (C). The exact command to use is defined in the file 
/usr/spool/lp/remote, and the "printer" device defined by Ipadmin 
(using the -v flag) should be /dev/mill. 

Recognized lp(C) options are: 

-oli 

The input files are in imPRESS format but with no document 
header. 

-olp 

The input files are text for line printing, 
-olfi 

The input files are in full imPRESS format with a document header, 
-olt 

The input files are troff input. 
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-oldvi 

The input files are DVI format ( output), to be filtered through 
dviimp(CT). 

-olc 

The input files are troff output (C/A/T format), to be filtered through 
catimpiCT). 

-otflag 

Pass option flag to troff. 

-ocflag 

Pass option flag to catimp . 

-o\flag 

Pass option flag to dviimp . 

-oiflag 

flag is an IMAGEN printer control setting: 

1 Print one page per sheet of paper. 

2 Print two pages per sheet of paper. 
O Print outlines around the page. 

r Print pages opposite (reverse) of usual order. 

c Do not collate pages of multiple copies. 

R Print rules on pages (one every two lines). 

J Suppress printing the job header (banner) page. 

m Do not print detailed error messages on the banner page. 

j Enables jam resistance measures. The default jam resistance 
action is controlled by the setting of JAMPROOF in the file 
/etc/default/imagen. 

Not all control settings are meaningful for every IMAGEN printer 
language. 

-ob 

No banner information about the local user or host should be gen- 
erated. 

-ohhost 

The computer responsible for this job is host. 
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-ouuser 

The person responsible for this job is user. 

All of the imagen interface scripts read /etc/default/imagen to obtain 
various default settings. The values obtained, and the default values, 
are: 

JAMPROOF=no 

Whether or not paper-jam resistance measures should be used. If 
such steps are taken, printing is usually slowed down. 

The values of the default settings can be changed to reflect the local 
system configuration. If /etc/default/imagen does not exist or cannot 
be read, the above default values are used. 



Files 

/usr/bin/itroff 

troff for an IMAGEN printer. 

/usr/bin/catimp 

Converts from troff C/A/T output to imPRESS format. 

/usr/bin/dviimp 

Converts from DVI to imPRESS format. 

/usr/lib/ips 

(imagen.spp) IMAGEN serial sequence packet protocol, 
/usr/lib/isbs 

(imagen.sbs) IMAGEN serial byte stream protocol, 
/usr/lib/ipbs 

(imagen.pbs) IMAGEN parallel byte stream protocol. 

/usr/spool/lp/ remote 

(imagen.remote) Mapping from local printer name to remote or 
uux command. Each line is in the format: 

printer: command 

where printer is the name of the "local" IMAGEN printer, and 
command is either a remote or uux invocation of Ip on another 
machine. The other machine must be configured so that a remote 
Ip is allowed, and the local command should specify whatever 
options are necessary so that the input can be piped into it. Addi- 
tional flags to Ip are appended onto the end of command by 
imagen.remote . A typical remote command would be: 

printer : remote - machine lp -dimagen 
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and a typical uux command would be: 

printer : uux - machine !lp -dimagen 



See Also 



catimp(CT), dviimp(CT), imprint(C), lp(C), lpadmin(ADM), 
ips(ADM), itroff(CT), remote(C), uux(C) 



Author 

IMAGEN Corporation. 
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Name 

init, inir - Process control initialization. 



Syntax 

/etc/init 
/etc/inir 



Description 

The init program is invoked as the last step of the boot procedure and 
as the first step in enabling terminals for user logins, init is one of 
three programs (init, getty(M), and login(M)) used to initialize a sys- 
tem for execution. 

init creates a process for each terminal on which a user may log in. It 
begins by opening the console device, /dev/console, for reading and 
writing. It then invokes a shell which prompts for a password to start 
the system in "maintenance mode". If at this prompt an EOF is read, 
the system proceeds toward "multi-user mode". If the root pasword is 
entered, a shell is started and attached to the console. When this shell 
is terminated the system proceeds toward ' 'multi-user mode' '. 

If the system was automatically loaded at boot time, init will be 
passed a -a flag when it is started, init also passes this flag to the pro- 
grams it runs so they may choose to behave differently under 
autoboot(ADM) conditions. 

The user may boot and the filesystem may be dirty. In this case, inir 
prompts the user, asking whether to do an fsck (ADM) (See fsck 
(ADM) for more information.) 

The user may boot and the filesystem may be clean. In this case, init 
reads commands from the /etc/rc file. This is followed by the 
"multi-user/rc" and the "getty/login" procedures as documented 
below. 

' 'multi-user Ire" procedure: Once the filesystem is clean, the shell ter- 
minates, and init performs several steps to begin normal operation. It 
invokes a shell and reads the commands in the /etc/rc file. This com- 
mand file performs housekeeping tasks such as removing temporary 
files, mounting file systems, and starting daemons. Then it reads the 
file /etc/ttys and forks several times to create a process for each termi- 
nal device in the file. Each line in the /etc/ttys lists the state of the 
line (0 for closed, 1 for open), the line mode, and the serial line (see 
ttys(P)). Each process opens the appropriate serial line for reading 
and writing, assigning the file descriptors 0, 1, and 2 to the line and 
establishing it as the standard input, output, and error files. If the 
serial line is connected to a modem, the process delays opening the 
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line until someone has dialed up and a carrier has been established on 
the line. 

' 'gettyllogin " procedure: Once init has opened a line, it executes the 
getty program, passing the line mode as an argument. The getty pro- 
gram reads the user's name and invokes login(M) to complete the 
login process (see getty (M) for details), init waits until the user logs 
out by typing ASCII end-of-file (Ctrl-D) or by hanging up. It responds 
by waking up and removing the former user's login entry from the file 
utmp, which records current users, and makes a new entry in the file 
wtmp, which is a history of logins and logouts. Then the correspond- 
ing line is reopened and getty is reinvoked. 

init has special responses to the hangup, interrupt, and quit signals. 
The hangup signal SIGHUP causes init to change the system from nor- 
mal operation to maintenance mode. The interrupt signal SIGINT 
causes init to read the ttys file again to open any new lines and close 
lines that have been removed. The quit signal SIGQUIT causes init to 
disallow any further logins. In general, these signals have a signifi- 
cant effect on the system and should not be used by a inexperienced 
user. Instead, similar functions can be safely performed with the 
enable (C), disable (C), and shutdown(ADM) commands. 

Files 

/dev/tty* 

/etc/utmp 

/usr/adm/wtmp 

/etc/default/boot 

/etc/ttys 

/etc/rc 

/etc/gettydefs 



See Also 

autoboot(ADM), telenit(ADM), disable(C), enable(C), login(M), 
kill(C) sh(C), shutdown(ADM), ttys(F), getty(M), gettydefs(F), 
inittab(F) 



Diagnostics 

If seven or more getty processes are started on the same line in five 
minutes or less, init writes an error message to /dev/console and 
refuses to start another getty on that line for at least 30 minutes. If 
desired, init will try again immediately if a SIGINT is sent. 

Notes 

init can only be invoked by the kernel as process 1. It cannot be 
invoked from the shell prompt. 
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For users more familiar with the telenit approach to terminal adminis- 
tration, inittab is provided. For more information, see telenit(ADM) 
and inittab(F). 
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Name 

Id - Invokes the link editor. 



Syntax 

Id [ options ] filename... 



Description 

Id is the XENIX link editor. It creates an executable program by com- 
bining one or more object files and copying the executable result to 
the file a.out. The filename must name an object or library file. 
These names must have the ".o" (for object) or ".a" (for archive 
library) extensions. If more than one name is given, the names must 
be separated by one or more spaces. If errors occur while linking, Id 
displays an error message; the resulting a.out file is unexecutable. 

Id concatenates the contents of the given object files in the order given 
in the command line. Library files in the command line are examined 
only if there are unresolved external references encountered from pre- 
vious object files. Library files must be in ranlib(CP) format, that is, 

the first member must be named .SYMDEF, which is a dictionary 

for the library. The library is searched iteratively to satisfy as many 
references as possible and only those routines that define unresolved 
external references are concatenated. Object and library files are pro- 
cessed at the point they are encountered in the argument list, so the 
order of files in the command line is important. In general, all object 
files should be given before library files. Id sets the entry point of the 
resulting program to the beginning of the first routine. 

There are the following options: 

-A num 

Creates a standalone program whose expected load address (in 
hexadecimal) is num. This option sets the absolute flag in the 
header of the a.out file. Such program files can only be executed as 
standalone programs. Options -A and -F are mutually exclusive. 

-B num 

Sets the text selector bias to the specified hexadecimal number, 
-c num 

Alters the default target CPU in the x.out header, num can be 0, 1, 
2, or 3 indicating 8086, 80186, 80286 and 80386 processors, 
respectively. The default on 8086/80286 systems is 0. The default 
on 80386 systems is 3. Note that this option only alters the default; 
if object modules containing code for a higher numbered processor 
are linked, then that will take precedence over the default. 
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-C 

Causes the link editor to ignore the case of symbols. 
-D num 

Sets the data selector bias to the specified hexadecimal number. 
-C5 

Turns on a bit to invoke /usr/Iib/coffconv with the linker, produc- 
ing an x.out COFF-compatible binary. 

-CX 

Turns off bit set with -C5, which resides in the header of the object 
file. 

-F num 

Sets the size of the program stack to num bytes where num is a 
hexadecimal number. This option is ignored for 80386 programs 
which have a variable sized stack. By default 8086 programs have 
a variable stack located at the top of the first data segment, and 
80286 programs have a fixed size 4096 byte stack. The -F option 
is incompatible with the -A option 



Creates separate instruction and data spaces for small model pro- 
grams. When the output file is executed, the program text and data 
areas are allocated separate physical segments. The text portion 
will be read-only and shared by all users executing the file. 

-La 

Sets advisory file locking. Advisory locking is used on files with 
access modes that do not require mandatory locking. 

-Lm 

Sets mandatory file locking. Mandatory file locking is used on files 
that cannot be opened by more than one user at the same time. 

-m name 

Creates a link map file named name that includes public symbols. 
-Ms 

Creates a small model program and checks for errors, such as fixup 
overflow. This option is reserved for object files compiled or 
assembled using the small model configuration. This is the default 
model if no -M option is given. 

-Mm 

Creates middle model program and checks for errors. This option 
is reserved for object files compiled or assembled using the middle 
model configuration. This option implies -i . 
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-Ml 

Creates a large model program and checks for errors. The option is 
reserved for object files compiled using the large model 
configuration. This option implies -i . 

-Mr 

Specifies the memory model, x can have the following values: 

s small 

m middle 

1 large 

h huge 

e mixed 

-n num 

Truncates symbols to the length specified by num. 
-N num 

Sets the pagesize to hex-nwra (which should be a multiple of 512) - 
the default is 1024 for 80386 programs. 8086/80186/80286 pro- 
grams do not normally have page-aligned x.out files and the default 
for these is 0. 

-o name 

Sets the executable program filename to name instead of a.out. 

-P 

Disables packing of segments 

-r Invokes the incremental linker, /lib/ldr , with the arguments 
passed to Id to produce a relocatable output file. 

-R Ensures that the relocation table is of non-zero size. Important for 
8086 compatibility. 

-Rd num 

Specify the data segment relocation offset (80386 only), num is 
hexadecimal. 

-Rt num 

Specify the text segment relocation offset (80386 only) num is hex- 
adecimal. 

-s 

Strips the symbol table. 
-S num 

Sets the maximum number of segments to num. If no argument is 
given, the default is 128. 

-u symbol 

Designates the specified symbol as undefined. 
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-v num 

Specifies the XENIX version number. Acceptable values for num 
are 2, 3, or 5; 5 is the default. 

Id should be invoked using the cc (CP) instead of invoking it directly. 
Cc invokes Id as the last step of compilation, providing all the neces- 
sary C-language support routines. Invoking Id directly is not recom- 
mended since failure to give command line arguments in the correct 
order can result in errors. 



Files 

/bin/Id 



See Also 

ar(CP), cc(CP), ld(CP), masm(CP), ranlib(CP) 



Notes 

The user must make sure that the most recent library versions have 
been processed with ranlib(CP) before linking. If this is not done, Id 
cannot create executable programs using these libraries. 
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Name 

login - Gives access to the system. 



Description 

The login command is used at the beginning of each terminal session 
to identify the user and allow them access to the system. It cannot be 
invoked except when a connection is first established, or after the pre- 
vious user has logged out by sending an end-of-file ( Ctrl-D ) to his ini- 
tial shell. 

login prompts for user name, and if appropriate, a password. Echoing 
is turned off (where possible) while the password is being entered, so 
it will not appear on the written record of the session. 

It is possible to assign an additional password to dial-in lines for addi- 
tional security. This is discussed below in "Dial-in Passwords." 

If the login sequence is not completed successfully within a certain 
period of time (e.g., one minute), the user is returned to the "login:" 
prompt or silently disconnected from a dial-in line. 

After a successful login, accounting files (letclutmp and /etc/wtmp) are 
updated, the user is notified if they have mail, and the start-up shell 
files (i.e., .profile for the Bourne shell or .login for the C-shell) if any, 
are executed. 

login checks /etc/default/login for ULIMIT (maximum file size in 
512 byte blocks, default is 2,097,152), and for environment variables, 
such as TZ (time zone), HZ (hertz), and ALTSHELL (allows other 
than sh shell types). Other entries sometimes found in 
/etc/default/login are IDLEWEEKS, CONSOLE, and PASSREQ. 
IDLEWEEKS=n, where n is a number of weeks, works in conjunction 
with pwadmin(ADM). If a password has expired, the user is prompted 
to choose a new one. If it has expired beyond IDLEWEEKS, the user 
is not allowed to log in, and must consult system administrator. The 
CONSOLE=/dev/?. ? ? entry means that root can only log in on the 
/dev listed. PASSREQ=YES, if set, forces the user to select a pass- 
word if they do not have one. 

login initializes the user and group IDs and the working directory, 
then executes a command interpreter (usually sh (C)) according to 
specifications found in the /etc/passwd file. Argument of the com- 
mand interpreter is a dash (-) followed by the last component 
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of the interpreter's pathname. The basic environment (see 
environ (M)) is initialized to: 

HOME= your-login-directory 

PATH=:/bin:/usr/bin 

SHELL=/oy/ field ofpasswd entry 

MATL=/usr/spooVmai\/your-login-name 

T7j=timezone-specification 

Initially, umask is set to octal 022 by login. 

If a user's UID is (i.e. if this is the superuser), the PATH variable is 
set to SUPATH, if SUPATH is specified in /etc/ default/ login. If it is 
not, PATH is set to the following: 

PATH=:/bin :/usr/bin:/etc 

It is not advisable for SUPATH to include the current directory symbol 
(•)• 



Dial-in Passwords 

If desired, special dial-in passwords can be defined for selected tty 
lines, requiring selected classes of users to input these passwords. 
Logging information, including the last time of connection, can be 
stored for later use. 

Specific dial-in lines that require passwords are defined in the file 
/etc/dialups. The actual dialup passwords are kept in the file 
/etc/d_passwd. The password must be generated /etc/passwd an 
transferred. 

The first field ("user name") in /etc/d_passwd is the name of a shell 
program (for example, /bin/sh) used in /etc/passwd. If the login shell 
of the user attempting to log in (on a tty line listed in /etc/dialups) is 
listed in /etc/d_passwd, then the user is prompted for the dial-in pass- 
word stored in letcld _passwd. (A shell name of "*" in /etc/d_passwd 
specifies the default dialup password.) 

A sample /etc/d_passwd file might be: 

*:<encrypted passwd>:Defau\t dialup password 
/usr/lib/uucp/uucico: :UUCP dialup password (none) 
/bm/rsh:<encrypted passwd> Restricted shell user dialup password 

To enable time-of-login recording (and reporting of the time of last 
login at each login), create the log file /usr/adm/lastlog. This file 
should be owned by /bin and group bin; the permissions can be res- 
tricted to 600 if desired. If this file exists and the user is not currently 
logged in, the finger(C) utility will report the time of last login. 
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Files 



/etc/utmp 



Information on current logins 



/etc/wtmp 



History of logins since last multiuser 



/usr/spool/mail/ name 



Mailbox for user name 



/etc/motd 



Message of the day 



/etc/default/login 



Default values for environment 
variables 



/etc/passwd 



Password file 



/etc/profile 



System profile 



$HOME/.profile 



Personal profile 



See Also 



environ(M), getty(ADM), machine(M), mail(C), newgrp(C), 
passwd(C), passwd(F), profile(M), su(C), sh(C), ulimit(S), umask(C), 
who(C). 



Diagnostics 

Login incorrect 

The user name or the password is incorrect. 

No shell, cannot open password file, no directory: 
Your account has not been properly set up. 

Your password has expired . Choose a new one . 

Password aging is implemented and yours has expired. 



Only the superuser may execute login from a shell. 

As explained in machine(M), when setting ULIMIT in the 
/etc/default/login file on filesy stems with 1024 byte blocks (see 
machine(M)), be sure to specify even numbers, as the ULIMIT vari- 
able accepts a number of 512-byte blocks. The default is 2,097,152 
blocks, or 1 gigabyte. Use this variable to increase or decrease the 
maximum allowable file size. 
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Name 

mapchan - Configure tty device mapping. 



Syntax 

mapchan [-ans] [ -f mapfile ] [ channels ... ] 
mapchan [ [ -o ] [ -d ] ] [ channel ] 



Description 

mapchan configures the mapping of information input and output of 
XENIX. The mapchan utility is intended for users of applications that 
employ languages other than English (character sets other than 7-bit 
ASCII). 

mapchan translates codes sent by peripheral devices, such as termi- 
nals, to the internal character set used by the XENIX system, mapchan 
can also map codes in the internal character set to other codes, for out- 
put to peripheral devices (such as terminals, printers, console screen, 
etc.). Note that PC keyboard configuration is accomplished through 
the mapkey (M) utility. 

mapchan has several uses: to map a channel (-a or -s); to unmap a 
channel (-n and optionally -a); or to display the map on a channel 
(optionally -o, -d, channels). 

mapchan with no options displays the map on the user's channel . The 
map displayed is suitable as input for mapchan . 

The options are: 

-a when used alone, sets all channels given in the default file 
(/etc/default/mapchan) with the specified map. When used 
with -n, it refers to all channels given in the default file. Super- 
user maps or unmaps all channels , other users map only chan- 
nels they own. -a can not be used with -d, -o, or -s. 

-d causes the mapping table currently in use on the given device, 
channel , to be displayed in decimal instead of the default hexa- 
decimal. An ASCII version is displayed on standard output. This 
output is suitable as an input file to mapchan for another chan- 
nel. Mapped values are displayed. Identical pairs are not out- 
put, -d can not be used with -a, -f, -n, -o, or -s. 

-f causes the current channel or list of channels to be mapped with 
mapfile . -f can not be used with -d, -n, -s, or -o. 



May 16, 1988 



Page 1 



MAPCHAN (M) 



MAPCHAN (M) 



-n causes null mapping to be performed. All codes are input and 
output as received. Mapping is turned off for the user's channel 
or for other channels , if given, -a used with -n will turn map- 
ping off on all channels given in the default file. This is the 
default mapping for all channels unless otherwise configured. - 
n can not be used with -d, -f, -o, or -s. 

-o causes the mapping table currently in use on the given device, 
channel, to be displayed in octal instead of the default hexade- 
cimal. An ASCII version is displayed on standard output. This 
output is suitable as an input file to mapchan for another port. 
Mapped values are displayed. Identical pairs are not output, -o 
can not be used with -a, -d, -f, -n, or -s. 

-s sets the user's current channel with the mapfile given in the 
default file, -s can not be used with any other option. 

The user must own the channel in order to map it. The super-user can 
map any channel. Read or write permission is required to display the 
map on a channel. 

Each tty device channel (display adapter and video monitor on com- 
puter, parallel port, serial port, etc.) can have a different map. When 
XENIX boots, mapping is off for all channels . 

mapchan is usually invoked in the /etc/rc file. This file is executed 
when the system enters multi-user mode and sets up the default map- 
ping for the system. Users can invoke mapchan when they log in by 
including a mapchan command line in their .profile or .login file. In 
addition, users can remap their channel at any time by invoking map- 
chan from the command line, channels not listed in the default file are 
not automatically mapped, channels are not changed on logout. What- 
ever mapping was in place for the last user remains in effect for the 
next user, unless they modify their .profile or .login file. 

For example, the default file /etc/default/mapchan can contain: 

tty02 ibm 



The default directory containing mapfiles is /usr/lib/mapchan. The 
default directory containing channel files is /dev. Full pathnames may 
be used for channels or mapfiles. If a channel has no entry, or the 
entry field is blank, no mapping is enabled on that channel. Addi- 
tional channels added to the system, (for example, adding a serial or 
parallel port) are not automatically entered in the mapchan default 
file. If mapping is required, the system administrator must make the 
entries. 



tty la 
tty2a 
IP 



wy60.ger 
ibm 
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The format of the mapfiles is documented in the mapchan(F) manual 
page. 



Using a Mapped channel 

The input information is assumed to be 7- or 8-bit codes sent by the 
peripheral device. The device may make use of "dead" or "com- 
pose' ' keys to produce the codes. If the device does not have dead or 
compose keys, these keys can be simulated using mapchan. 

One to one mapped characters are displayed when the key is pressed, 
and the mapped value is passed to the kernel. 

Certain keys are designated as dead keys in the mapfile. Dead key 
sequences are two keystrokes that produce a single mapped value that 
is passed to the kernel. The dead key is usually a diacritical character, 
the second key is usually the letter being modified. For example, the 
sequence ' e could be mapped to the ASCII value 0xE9, and display as 
e. 

One key is designated as the compose key in the mapfile. Compose 
key sequences are composed of three keystrokes that produce a single 
mapped value that is passed to the kernel. The compose key is usually 
a seldom used character or oxA-letter combination. The second key is 
usually the letter being modified. The third key may be another char- 
acter being combined, or a diacritical character. For example, if '@ ' is 
the compose key, the sequence @ c could be mapped to the ASCII 
value 0xA9, and display as ©. 

Characters are not echoed to the screen during a dead or compose 
sequence. The mapped character is echoed and passed to the kernel 
once the sequence is correctly completed. 

Characters are always put through the input map, even when part of 
dead or compose sequences. The character is then checked for the 
internal value. The value may also be mapped on output. This should 
be kept in mind when preparing map files. 

The following conditions will cause an error during input: 

non-recognized (not defined in the mapfile) dead or compose sequence 
restarting a compose sequence before completion by pressing the 
compose key in the middle of a dead or compose sequence. This is an 
error, but a new compose sequence is initiated. 

If the mapfile contains the keyword beep , a bell sounds when either of 
the above conditions occurs. In either case, the characters are not 
echoed to the screen, or passed to the kernel. 
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In order to allow for character sequences sent to control the terminal 
(move the cursor, and so on) rather than to print characters on the 
screen, mapchan allows character sequences to be specified as special 
sequences which are not passed through the normal mapping pro- 
cedure. Two sections may be specified, one for each of the input (key- 
board) and output (screen) controls. 



Character Sets 

The internal character set used by XENIX is defined by the mapfiles 
used. By default, this is the ISO 8859/1 character set which is also 
known as the dpANS X3.4.2 and ISO/TC97/SC2. It supports most of 
the Latin alphabet and can represent most European languages. 

Several partial map files are provided as examples. They must be 
modified for use with specific peripheral devices. Consult your 
hardware manual for the codes needed to display the desired charac- 
ters. Two map files are provided for use with the console device: 
/usr/lib/mapchan/ibm for systems with a standard PC character set 
ROM, and /usr/lib/mapchan/iso for systems with an optional ISO 
8859/1 character set ROM. 

Care should be taken that the sttyiC) settings are correct for 8-bit ter- 
minals. The /etc/gettydefs file may require modification to allow log- 
ging in with the correct settings. 

7-bit U.S. ASCII (ANSI X3.4) should be used if no mapping is enabled 
on the channel . 



Files 

/etc/default/mapchan 
/usr/lib/mapchan/* 



See Also 

ascii(M), keyboard(HW), lp(C), lpadmin(ADM), mapchan(F), 

mapkey(M), parallel(HW), screen(HW), serial(HW), setkey(M), 
trchan(M), tty(M) 



Notes 

Some non-U.S. keyboards and display devices do not support charac- 
ters commonly used by XENIX command shells and the C program- 
ming language. It is not recommended that these devices be used for 
system administration tasks. 



May 16, 1988 



Page 4 



MAPCHAN (M) 



MAPCHAN (M) 



Printers can be mapped, output only, and can either be sent 8-bit codes 
or one-to-many character strings using mapchan. Line printer spooler 
interface scripts can be used (setuid root) to change the output map on 
the printer when different maps are required (as in changing print 
wheels to display a different character set). See lp(C) and 
Ipadmin(ADM) for information on installing and administering inter- 
face scripts. 

Not all terminals or printers can display all the characters that can be 
represented using this utility. Refer to the device's hardware manual 
for information on the capabilities of the peripheral device. 



Warnings 

Use of mapfiles that specify a different "internal" character set per- 
channel, or a set other than the 8-bit ISO 8859 set supplied by default 
can cause strange side effects. It is especially important to retain the 
7-bit ASCII portion of the character set (see asciiQA)). XENIX utili- 
ties and many applications assume these values. 

Media transported between machines with different internal code set 
mappings may not be portable as no mapping is performed on block 
devices, such as tape and floppy drives. However, trchan with an 
appropriate mapfile can be used to "translate" from one internal char- 
acter set to another. 

Do not set ISTRIP (see stty(C)) when using mapchan. This option 
causes the eighth bit to be stripped before mapping occurs. 
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Name 

mapkey, mapscm, mapstr, convkey - Configure monitor screen map- 
ping. 

Syntax 

mapkey [ -dox ][ datafile ] 
mapscrn [ -d ][ datafile ] 
mapstr [ -d ][ datafile ] 
convkey [ in [ out ] ] 



Description 

mapscrn configures the output mapping of the monitor screen on 
which it is invoked, mapkey and mapstr configure the mapping of the 
keyboard and string keys (eg. function keys) of the monitor (and mul- 
tiscreens if present), mapkey can only be run by the super-user. 

mapstr functions on a per-screen basis. Mapping strings on one screen 
does not affect any other screen. 

If a file name is given on the argument line the respective mapping 
table is configured from the contents of the input file. If no file is 
given, the default files in /usr/lib/key board and /usr/lib/console is 
used. The -d option causes the mapping table to be read from the ker- 
nel instead of written and an ASCII version to be displayed on the 
standard output. The format of the output is suitable for input files to 
mapscrn, mapkey, or mapstr . Non-super-users can run mapkey and 
mapstr when the -d option is given. 

With the -o or -x options, mapkey displays the mapping table in octal 
or hexadecimal. 

convkey translates an old-style mapkey file into the current format. If 
in or out are missing, they default to stdin or stdout. 



Files 

/usr/lib/keyboard/* 
/usr/lib/console/* 



Notes 

There is no way to specify that the map utilities read their configura- 
tion tables from standard input. 
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See Also 

keyboard(HW), screen(HW), setkey(C) 
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Name 

messages - Description of system console messages. 
Description 

This section describes the various system messages which may appear 
on the system console. All messages are displayed in the following 
format: 

label '.severity : comment 

The segments break down as follows: 

label 

Name of the driver or routine where the error occurred. 
severity 

The level of error severity, consisting of four levels: 

PANIC These fatal messages indicate hardware 

problems or kernel inconsistencies that 
are too severe for continued operation. 
After displaying a PANIC message, the 
system stops. Rebooting is required. 

ERROR Resource use has been affected. Some 
corrective action is needed. 

WARNING An error indication that should be moni- 
tored (example, free file space is low) 
but requires no immediate action. 

INFO Some information about the system is 

provided. 

comment 

A field containing information about the problem at hand. 
action 

The course of action to remedy the situation. 

The system services error messages are generated by the shell and do 
not follow the above convention. 

System Message Meanings 

The following classifications are meant to be a key for you to use to 
determine the actions to take to correct an error situation. Each kernel 
message will have one of the following three classifications listed 
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with it. The classifications are: 

System inconsistency 

A contradictory situation exists in the kernel. 

Abnormal 

A probably legitimate but extreme situation exists. 

Hardware 

Indicates a hardware problem. 

System inconsistency messages indicate problems usually traceable to 
hardware malfunction, such as memory failure. These messages 
rarely occur since associated hardware problems are generally 
detected before such an inconsistency can occur. 

Abnormal messages represent kernel operation problems, such as the 
overflow of critical tables. It takes extreme situations to bring these 
problems about, so they should never occur in normal system use. 
However, in some cases you can modify the kernel parameters that are 
causing the error message. Use the configure(C) utility to make the 
necessary changes. 

Hardware messages normally specify the device, dev, that caused the 
error. Each message gives a device specification of the form nnlmm 
where nn is the major number of the device, and mm is its minor 
number. The command pipeline 

Is -1 /dev | grep nn | grep mm 

may be used to list the name of the device associated with the given 
major and minor numbers. 



System Messages 

** Normal System Shutdown ** 

This message appears when the system has been shutdown prop- 
erly. It indicates that the machine may now be rebooted or 
powered down. 

kemelrPANIC:** ABNORMAL System Shutdown ** 

This message appears when errors occur during system shut- 
down. It is usually accompanied by other system messages. 
System inconsistency, fatal. 

kernel:WARNING:bad block on dev nnlmm 

A nonexistent disk block was found on, or is being inserted in, 
the structure's free list. System inconsistency. 
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kernel:WARNING:bad count on dev nnjmm 

A structural inconsistency in the superblock of a file system. 
The system attempts a repair, but this message will probably be 
followed by more complaints about this file system. System 
inconsistency. 

kernel:WARNING:Bad free count on dev nn/mm 

A structural inconsistency in the superblock of a file system. 
The system attempts a repair, but this message will probably be 
followed by more complaints about this file system. System 
inconsistency. 

kernel:ERROR:error on dev name (nn/mm) 

This is the way that most device driver diagnostic messages 
start. The message will indicate the specific driver and com- 
plaint. The name is a word identifying the device. 

kernel:ERROR:iaddress > 2"24 

This indicates an attempted reference to an illegal block 
number, one so large that it could only occur on a file system 
larger than 8 billion bytes. Abnormal. 

kernel:WARNING:Inode table overflow 

Each open file requires an inode entry to be kept in memory. 
When this table overflows, the specific request (usually open(S) 
or creat(S)) is refused. Although not fatal to the system, this 
event may damage the operation of various spoolers, daemons, 
the mailer, and other important utilities. Abnormal results and 
missing data files are a common result. Use configureiC) to 
raise the number of inodes. Abnormal. 

kernel:WARNING:interrupt from unknown device, \ec=num 

The CPU received an interrupt via a supposedly unused vector. 
This message is followed by "panic:unknown interrupt." Typi- 
cally, this event comes about when a hardware failure miscom- 
putes the vector of a valid interrupt. Hardware. 

kernel:WARNING:stray interrupt on vector num 

The CPU received an interrupt via a supposedly unused vector. 
Hardware. 
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kernel: WARNING:no file 

There are too many open files. The system has run out of entries 
in its "open file" table. The warnings given for the message 
"inode table overflow" apply here. Use configure(C) to raise 
the total number of available files. Note that the number of open 
files per process is not configurable. Abnormal. 

kernel: WARNING:no space on dev nn/mm 

This message means that the specified file system has run out of 
free blocks. Although not normally as serious, the warnings dis- 
cussed for "inode table overflow" apply :often user programs 
are written casually and ignore the error code returned when 
they tried to write to the disk; this results in missing data and 
"holes" in data files. The system administrator should keep 
close watch on the amount of free disk space and take steps to 
avoid this situation. Abnormal. 

kernel:WARNING:Out of inodes on dev nn/mm 

The indicated file system has run out of free inodes. The number 
of inodes available on a file system is determined when the file 
system is created (using mkfs(C)). The default number is quite 
generous; this message should be very rare. The only recourse 
is to remove some worthless files from that file system, or dump 
the entire system to a backup device, run mkfs(C) with more 
inodes specified, and restore the files from backup. Abnormal. 

kernel: WARNING:out of text 

When programs linked with the Id -i or -n switch are run on a 
286 based machine, a table entry is made so that only one copy 
of the pure text will be in memory even if there are multiple 
copies of the program running. This message appears when this 
table is full. The system refuses to run the program which 
caused the overflow. Note that there is only one entry in this 
table for each different pure text program. Multiple copies of 
one program will not require multiple table entries. Each 
"sticky" program (see chmod(C)) requires a permanent entry in 
this table; nonsticky pure text programs require an entry only 
when there is at least one copy being executed. Use 
configure(ADM) to raise the number of text segments. Abnor- 
mal. 

kernel:PANIC:bad 287 int 

Attempted execution of a real mode 287 instruction on a 286 
based machine. System inconsistency, fatal. 

kernel:PANIC:blkdev 

An internal disk I/O request, already verified as valid, is 
discovered to be referring to a nonexistent disk. System incon- 
sistency, fatal. 
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kernel:PANIC:devtab 

An internal disk I/O request, already verified as valid, is 
discovered to be refering to a nonexistent disk. System incon- 
sistency, fatal. 

kernel:PANIC:iinit 

The super-block of the root file system could not be read. This 
message occurs only at boot time. Hardware, fatal. 

kernel:PANIC:swap 10 error 

A fatal I/O error occurred while reading or writing the swap 
area. System inconsistency, fatal. 

kernel:PANIC:memory failure - parity error 

A hardware memory failure trap has been taken. System incon- 
sistency, fatal. 

kernel:PANIC:no fs 

A mounted file system's entry has disappeared from the system 
mount table. System inconsistency, fatal. 

kernel:PANIC:no imt 

A mounted file system has disappeared from the mount table. 
System inconsistency, fatal. 

kernel:PANIC:no procs 

Each user is limited in the amount of simultaneous processes he 
can have; an attempt to create a new process when none is 
available or when the user's limit is exceeded and refused. That 
is an occasional event and produces no console messages; this 
panic occurs when the kernel has certified that a free process 
table entry is available and can't find one when it goes to get it. 
System inconsistency, fatal. 

kernel:PANIC:Out of swap 

There is insufficient space on the swap disk to hold a task. The 
system refuses to create tasks when it feels there is insufficient 
disk space, but it is possible to create situations to circumvent 
this mechanism. Note that this condition generates a PANIC on 
286 based machines and a WARNING on 386 based machines. 
Abnormal. 

kernel:PANIC:general protection trap 

General protection trap taken in kernel. System inconsistency, 
fatal. 

kernel:PANIC:segment not present 

An attempt has been made to access an invalid segment. It may 
also indicate the segment-not-present trap has been taken in the 
kernel. System inconsistency, fatal. 
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kernel:PANIC:Timeout table overflow 

The timeout table is full. Timeout requests are generated by 
device drivers, there should usually be room for one entry per 
system serial line plus ten more for other usages. Use 
configure(C) to raise the number of timeout table entries. 

kernel:PANIC:Trap in system 

The CPU has generated an illegal instruction trap while execut- 
ing kernel or device driver code. This message is preceded with 
an information dump describing the trap. System inconsistency, 
fatal. 

kernel:PANIC:Invalid TSS 

Internal tables have become corrupted. System inconsistency, 
fatal. 

kernel:WARNING:bootstring invalid, ignored 

A bad bootstring was entered at the Boot prompt. 

kernel:ERROR:bad syntax - string 

A bad bootstring was entered at the Boot prompt. 

kernel:PANIC:bad mapping in copyio 

Copyio was called with a strange request. Usually a bad driver. 

kernel:WARNING:HARDWARE FAELURE:386 incorrectly multi- 
plies 32-bit numbers 

The cpu is displaying the 32-bit multiply bug. 

kernel:PANIC:*** POWER CYCLE TO REBOOT *** 

This message follows the above HARDWARE FAILURE 32 bit 
error message. 

kernel:iNFO:10 bits of I/O address decoding 

The hardware is only decoding 10 bits of i/o addresses. This 
amount is sufficient in most cases. This condition is only an 
issue if you are strapping i/o devices with a base address above 
400 (hex). 

kernel: WARNING: A3 1 CPU bug workaround not possible for this 
machine 

A3 1 was specified on the boot line, but cannot be applied to the 
current system. 

kernel:INFO:A31 CPU bug workaround in effect 

A3 1 was specified on the boot line and the software workaround 
is currently in effect. 

kernel:PANIC:bad boot string An invalid boot string was entered at 
the Boot prompt. 
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kernekPANIC:** WYSE/SCO XENIX only operates on WYSE PC 
systems ** 

A kernel was serialized for WYSE hardware only and is being 
booted on a non-WYSE machine. 

kernel:PANIC:out of both memory & swap 

No more memory pages or swap pages are free. 

kernel:PANIC:not enough contiguous memory 

The kernel memory allocation routines require more physically 
contiguous memory. Either decrease the size of some kernel 
parameters (like disk buffers) or add more physical memory. 

kernekWARNINGifilesystem page read failed 

An error occurred trying to read a page from the disk. This is 
not fatal, but usually indicates hardware problems. 

kernel:PANIC:free inode isn't 

There is internal inode table corruption within the kernel. 

kernel:ERROR:Map overflow (num), shutdown and reboot, mp- 
>mpent 

There are internal kernel map inconsistencies. Reboot your sys- 
tem. 

kernel:PANIC:write_sb():cannot cvts3superb() yet 

This message is found in the 386 kernel only. A write of a non 
SYS III or SYS V filesystem superblock is being attempted. 
This action should be impossible due to earlier checks. 

kernel:WARNING:Can't allocate message buffer 

This message indicates a lack of memory. Processes should be 
killed to make more room. Another option is to add more physi- 
cal memory. 

kernel:PANIC:Large model 386 ssig 

Internal kernel error in processing large model 386 signals. 

Trap type 

This message precedes a "kernekPANIC:" message. The type 
is the trap number given by the processor. The message is fol- 
lowed by a dump of registers. System inconsistency, fatal. 

fpsave:PANIC:no fp_task 

No floating point context to save, internal kernel error. 

mdep.386/fp.c:WARNING:No floating point emulator found in string, 
No /etc/ emulator was present in the root filesystem. The System 
Administrator should install one and reboot. 
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fp_OVERRUN:PANIC:coprocessor overrun - with no 287/387 
Internal coprocessor error, fatal. 

fp_COPROC:PANIC:, coprocessor error - with no 287/387 
Inconsistent kernel internal state. 

fp_COPROC:PANIC:coprocessor error - switched away from fp_task 
Internal kernel mismanagement of floating point processes. 

fp_DNA:PANIC: 

A device trap happened while emulating floating point instruc- 
tions. 

iinit:PANIC:cannot copy in superblock 

An error happened during the root filesystem superblock load- 
ing. 

srmount:PANIC:cannot cvtv7superb() yet 

A root filesystem superblock was not recognized as a SYS III or 
SYS V superblock. V7 superblocks cannot currently be con- 
verted on the 386 kernel. 

mapphys:PANIC:sptmap overflow 

No system page table pages are available. This is an internal 
error in the kernel, usually caused by a faulty device driver. 

physio:PANIC:bad state A device driver made an invalid request to 
physio. 

badint:PANIC:bad interrupt handler Invalid interrupt request, usually 
fault hardware. 

setup:PANIC:sptmap overflow This message indicates possible kernel 
image corruption or lack of physical memory. 

setup:PANIC:u-area not page aligned This indicates possible kernel 
image corruption. 

setup:PANIC:u-area address does not match SPTADDR 
Indicates possible kernel image corruption. 

cmn_err:PANIC:DOUBLE PANIC The kernel panicked while trying 
to panic. You must power cycle at this point to reboot the 
machine. 

cmn_err:PANIC:unknown level in cmn_err (level=«wm, msg=string), 
The kernel's cmn_err() routine was called with an invalid argu- 
ment. 
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Kernel Paging Messages 

The following messages indicate system inconsistencies in the kernel 
paging code. These inconsistencies can be caused by hardware or 
software problems. Reboot your system and note the circumstances if 
you see one of these messages: 

mfalloc:PANIC:page not free 

mfalloc:PANIC:page not free at exit 

mffree:PANIC:page already free 

mffree:PANIC:page is locked 

dfalloc:PANIC:frame not free at exit 

xlcheck:PANIC:xlink serial mismatch 

impcode:PANIC:called to load impure 386 

impcode:PANIC:more than 1 data segment? 

preload:PANIC:, invalid page {nam, num) 

kernel :PANIC:bad page type for protection fault 

kernel:PANIC:protection fault on read access 

kernel:PANIC:not present fault on shared data 

kemel:PANIC:added strange page table - num, index 

pgflnd:PANIC:not in cache 

pghash:PANIC:not in cache 

pginval:PANIC:list broken 

pginval:PANIC:not in cache 

mftomp:PANIC:bad frameno num 

mptomf:PANIC:bad mp num 

swapadd:PANIC:no space for dpfi 

dftodp:PANIC:bad frameno num 

dptodf:PANIC:bad dp num 
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dptodf:PANIC:bad dp num 

pgread:PANIC:no xlink 

pgfree:PANIC:invalid page marked present 

pgfree:PANIC:freeing intransit page 

pgpid:WARNING:setting disk pid 

kernel:PANIC:page table under page table? 

kernel:PANIC:swapping intransit page 

dftomf:PANIC:non-swap page table entry changed 

dftomf:PANIC:swap disk frame rcnt(«wra) != 1, dp=num, dp- 
>dp_rcnt,dp 

dftomf:PANIC:page type mismatch - mptype num dptype num mp num 
dp num, mp->mp_type, dp->dp_type, mp, dp 

dftomf2:PANIC:, swap memory frame rcnt(nwm) != 1 , mp=num, 

dftomf3:PANIC:swap mem frame rcnt(num) != 1, mp-num, mp- 
>mp_rcnt, mp 

mftodfl:PANIC:swap mem frame rcnt(nwm) != 1, mp=num, mp- 
>mp_rcnt, mp 

mftodf:PANIC:memory frame marked in transit 

mftodf:PANIC:page type mismatch - dptype num mptype num dp num 
mp num 

mftodf2:PANIC:swap disk frame rcnt(nwra) != 1, dp=num 

mftodf3:PANIC:swap disk frame rcnt(num) != 1, dp=num, dp- 
>dp_rcnt, dp 

fftomf:PANIC:page type(nwm) not TE_FBLSYS, mp = num,mp- 
>mp_type, mp 

mfcvt:PANIC:zero ref count 

ptdup:PANIC:TE_SWAP page vcnt(num) > 1, 

ptdup:PANIC:xlinked page has reference 

ptdup2:PANIC:TE_SWAP page rent > 1 
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ptdup:PANIC:xlinked page has reference 
ptdup:PANIC:locked page not present 
ptdup: PANIC :intransit page 

pgcheck:PANIC:page type mismatch:ptp num type num. xtype 
«um,ptp,type,xtype 

The above listed messages indicate system inconsistencies in the ker- 
nel paging code. These inconsistencies can be caused both by 
hardware or software problems. Reboot your system. 

cputok:PANIC: 

cpktou:PANIC: 

sdfrcm:PANIC:sdp->sd_inode not found 

The above 3 errors indicate internal shared data errors within the ker- 
nel. 

v86sighdlint:WARNING:lost signal 
v86setint:PANIC:xtss pte not present 

The above 2 errors indicate internal VPIX processing errors within the 
kernel. 

namei:PANIC:null cache ino 
namei:PANIC:duplicating cache 

The above 2 messages indicate internal file management errors in the 
kernel. 



System Services Messages 

The following messages are displayed by the shell when a system call 
fails. 

Not owner: 

Typically, this error indicates an attempt to modify a file in some 
way forbidden except to its owner or super-user. It is also returned 
for attempts by ordinary users to do things allowed only to the 
super-user. 

No such file or directory: 

This error occurs when a filename is specified and the file should 
exist but doesn't, or when one of the directories in a pathname does 
not exist. 
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No such process: 

No process can be found corresponding to that specified by pid in 
kill or ptrace . 

Interrupted system call: 

An asynchronous signal (such as interrupt or quit), which the user 
has elected to catch, occurred during a system call. If execution is 
resumed after processing the signal, it will appear as if the inter- 
rupted system call returned this error condition. 

I/O error: 

Some physical I/O error. This error may in some cases occur on a 
call following the one to which it actually applies. 

No such device or address: 

I/O on a special file refers to a subdevice which does not exist, or 
beyond the limits of the device. It may also occur when, for exam- 
ple, a tape drive is not on-line or no disk pack is loaded on a drive. 

Arg list too long: 

An argument list longer than 5,120 bytes is presented to a member 
of the exec family. 

Exec format error: 

A request is made to execute a file which, although it has the 
appropriate permissions, does not start with a valid magic number 
(see a.out(F)). 

Bad file number: 

Either a file descriptor refers to no open file, or a read (respectively 
write) request is made to a file which is open only for writing 
(respectively reading). 

No child processes: 

A wait was executed by a process that had no existing or 
unwaited-for child processes. 

No more processes: 

A fork failed because the system's process table is full or the user 
is not allowed to create any more processes. 

Not enough space: 

During an exec, or sbrk, a program asks for more space than the 
system is able to supply. This is not a temporary condition; the 
maximum space size is a system parameter. The error may also 
occur if the arrangement of text, data, and stack segments requires 
too many segmentation registers, or if there is not enough swap 
space during a. fork. 

Permission denied: 

An attempt was made to access a file in a way forbidden by the 
protection system. 
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Bad address: 

The system encountered a hardware fault in attempting to use an 
argument of a system call. 

Block device required: 

A nonblock file was mentioned where a block device was required, 
e.g., in mount. 

Device busy: 

An attempt to mount a device that was already mounted or an 
attempt was made to dismount a device on which there is an active 
file (open file, current directory, mounted-on file, active text seg- 
ment). It will also occur if an attempt is made to enable account- 
ing when it is already enabled. 

File exists: 

An existing file was mentioned in an inappropriate context, e.g., 
link . 

Cross-device link: 

A link to a file on another device was attempted. 

No such device: 

An attempt was made to apply an inappropriate system call to a 
device; e.g., read a write-only device. 

Not a directory: 

A nondirectory was specified where a directory is required, for 
example, in a path prefix or as an argument to chdir(S). 

Is a directory: 

An attempt to write on a directory. 

Invalid argument: 

An invalid argument (e.g., dismounting a nonmounted device; 
mentioning an undefined signal in signal or kill ; reading or writing 
a file for which Iseek has generated a negative pointer). Also set 
by the math functions described in the (S) entries of this manual. 

File table overflow: 

The system's table of open files is full and temporarily no more 
opens can be accepted. 

Too many open files: 

No process may have more than 60 file descriptors open at a time. 

Not a character device 

Text file busy: 

An attempt to execute a pure-procedure program which is 
currently open for writing (or reading). Also an attempt to open 
for writing a pure-procedure program that is being executed. 



May 16, 1988 



Page 13 



MESSAGES (M) 



MESSAGES (M) 



File too large: 

The size of a file exceeded the maximum file size (1,082,201,088 
bytes) orULIMIT; see ulimit(S). 

No space left on device: 

During a write to an ordinary file, there is no free space left on the 
device. 

Illegal seek: 

An Iseek was issued to a pipe. 

Read-only file system: 

An attempt to modify a file or directory was made on a device 
mounted read-only. 

Too many links: 

An attempt to make more than the maximum number of links 
(1000) to a file. 

Broken pipe: 

A write on a pipe for which there is no process to read the data. 
This condition normally generates a signal; the error is returned if 
the signal is ignored. 

Arg out of domain of func: 

The argument of a function in the math package is out of the 
domain of the function. 

Result too large: 

The value of a function in the math package is not representable 
within machine precision. 

File system needs cleaning: 

An attempt was made to mount(S) a file system whose super-block 
is not flagged clean. 

Would deadlock: 

A process' attempt to lock a file region would cause a deadlock 
between processes vying for control of that region. 

Not a name file: 

A creatsem(S), opensem(S), waitsem(S), or sigsem(S) was issued 
using an invalid semaphore identifier. 

Not available: 

An opensem(S), waitsem(S) or sigsem(S) was issued to a sema- 
phore that has not been initialized by a call to creatsem(S). A sig- 
sem was issued to a semaphore out of sequence; i.e., before the 
process has issued the corresponding waitsem to the semaphore. 
An nbwaitsem was issued to a semaphore guarding a resource that 
is currently in use by another process. The semaphore on which a 
process was waiting has been left in an inconsistent state when the 
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process controlling the semaphore exits without relinquishing con- 
trol properly; i.e., without issuing a waitsem on the semaphore. 

A name file: 

A name file (semaphore, shared data, etc.) was specified when not 
expected. 

No message of desired type: An attempt was made to receive a mes- 
sage of a type that does not exist on the specified message queue 
[see msgop(S)]. 

An attempt was made to receive a message of a type that does not 
exist on the specified message queue; see msgop(S). 

Identifier removed: 

This error is returned to a process that resumes execution due to 
the removal of an identifier from the file system's 
name space; see msgctl(S), semctl(S), and shmctl(S). 

No record locks available: 

lnfcntl(S) the setting or removing of record locks on a file cannot 
be accomplished because there are no more record entries left on 
the system. 

Channel number out of range 

Level 2 not synchronized 

Level 3 halted 

Level 3 reset 

Link number out of range 

Protocol driver not attached 

No CSI structure available 

Level 2 halted 

Deadlock situation detected/avoided 

A deadlock situation was detected and avoided. This error pertains 
to file and record locking. 

No record locks available 

Bad exchange descriptor 

Bad request descriptor 

Message tables full 
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Anode table overflow 

Bad request code 

Invalid slot 

File locking deadlock 

Bad font file format 

Not a stream device 

A putmsg(S) or getmsg(S) system call was attempted on a file 
descriptor that is not a STREAMS device. 

No data available 

Timer expired 

The timer set for a STREAMS ioctl(S) call has expired. The cause 
of this error is device specific and could indicate either a hardware 
or software failure, or perhaps a timeout value that is too short for 
the specific operation. The status of the ioctl(S) operation is 
indeterminate. 

Out of stream resources 

During a STREAMS open(S), either no STREAMS queues or no 
STREAMS head data structures were available. 

Machine is not on the network 

This error is Remote File Sharing (RFS) specific. It occurs when 
users try to advertise, unadvertise, mount, or unmount remote 
resources while the machine has not done the proper startup to 
connect to the network. 

Package not installed 

This error occurs when users attempt to use a system call from a 
package which has not been installed. 

Object is remote 

This error is RFS specific. It occurs when users try to advertise a 
resource which is not on the local machine, or try to 
mount/unmount a device (or pathname) that is on a remote 
machine. 

Link has been severed 

This error is RFS specific. It occurs when the link (virtual circuit) 
connecting to a remote machine is gone. 

Advertise error 

This error is RFS specific. It occurs when users try to advertise a 
resource which has been advertised already, or try to stop the RFS 
while there are resources still advertised, or try to force unmount a 
resource when it is still advertised. 
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Srmount error 

This error is RFS specific. It occurs when users try to stop RFS 
while there are resources still mounted by remote machines. 

Communication error on send 

This error is RFS specific. It occurs when trying to send messages 
to remote machines but no virtual circuit can be found. 

Protocol error 

Some protocol error occurred. This error is device specific, but is 
generally not related to a hardware failure. 

Multihop attempted 

This error is RFS specific. It occurs when users try to access 
remote resources which are not directly accessible. 

Not a data message 

During a read(S), getmsg(S), or ioctl(S) I_RECVFD system call to a 
STREAMS device, something has come to the head of the queue 
that can't be processed. That something depends on the system 
call: 

readiS) - control information or a passed file descriptor. 
getmsg(S) - passed file descriptor. 
ioctl(S) - control or data information. 

Name not unique on network 

File descriptor in bad state 

Remote address changed 

Cannot access a needed shared library 

Trying to exec(S) an a.out that requires a shared library (to be 
linked in) and the shared library doesn't exist or the user doesn't 
have permission to use it. 

Accessing a corrupted shared library 

Trying to exec(S) an a.out that requires a shared library (to be 
linked in) and exec(S) could not load the shared library. The shared 
library is probably corrupted. 

Trying to exec(S) an a.out that requires a shared library (to be linked 
in) and there was erroneous data in the .lib section of" the a.out. The 
.lib section tells exec(S) what shared libraries are needed. The 
a.out is probably corrupted. 

Attempting to link in more shared libraries than system limit 

Trying to exec(S) an a.out that requires more shared libraries (to be 
linked in) than is allowed on the current configuration of the sys- 
tem. See the System Administrator's Guide. 
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Cannot exec a shared library directly 

Trying to exec(S) a shared library directly. This is not allowed. 



Driver Messages 

The following messages are different from kernel messages in that 
they are generated by the device drivers for the various hardware sup- 
ported under XENIX. The source of the message can be determined by 
checking the label field of the message. 



Console Driver Messages 

console:WARNING:Kernel messages lost on non-text screen 
(also check /usr/adm/messages) 
Kernel messages were lost while the console was in graphics 
mode and did not appear. Check the last lines of 
/usr/adm/messages to find the messages. 

console:WARNING:Too many keyboard groups 

There are more video devices attached to your system than your 
kernel is designed to support. 



Irwin Driver Messages 

IRWIN:ERROR:Tape bad block table was not successfully read. 

When the tape device is open the bad block table is read into 
memory. This messages indicates that the read did not work 
correctly. 

IRWIN:ERROR:Tape is not formatted. 

The tape must be formatted before use. 

IRWIN:ERROR:Tape is write protected. 

The write protect tab must be removed for use. 

IRWIN:ERROR:Cannot write to DC 1000 cartridge. 

Only Irwin model 110 or 210 drives can write to DC 1000 car- 
tridges. 

IRWIN:ERROR:Not enough memory for mini-cartridge; retrying... 

The Irwin is waiting for enough user memory to become avail- 
able to use the device. 

IRWIN:ERROR:Not enough memory for mini-cartridge; open failed. 
The Irwin did not get enough memory to be able to use the dev- 
ice after several retries. 
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IRWIN:ERROR:Tape write error. 

A write attempt was unsuccessful for an unknown reason. 

IRWIN:ERROR:Tape verify error. 

A verify attempt was unsuccessful for an unknown reason. 

IRWIN:ERROR:Tape read error. 

A read attempt was unsuccessful for an unknown reason. 

IRWIN:ERROR:Tape uncorrectable ECC error. 

An uncorrectable ECC memory error has occurred, check your 
hardware for defective chips. 

IRWIN:ERROR:Cannot format DC 1000 cartridge. 

Only Irwin model 110 or 210 drives can write to DC 1000 car- 
tridges. 

IRWIN:ERROR:Bad state:num 

Unknown state in the interrupt routine. 

IRWIN:ERROR:DMA boundary error - start address:««m ending 
addressing//! 

Device tried to transfer data from a buffer that crosses a 64k 
boundary. 



Cartridge Driver Messages 

CT:ERROR:Tape controller (type=/ia/we) not found 

The controller specified in in the file lusrlsysliolctconf.asm was 
not found. 

CT:ERROR:Cartridge tape is write protected 

You must remove the write protect tab from the cartridge before 
use. 

CT:ERROR:system too busy for efficient tape use 

There is not enough user memory available to allow the device 
to work. 

CT:WARNING:attempted to free invalid buffer 

The driver attempted free a buffer that was not active. The buffer 
must be activated before use. 



SCSI Driver Messages 

scsi:ERROR:No controller response :num 

Requested controller is not present on SCSI bus num. Check 
your system setup and connections. 
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scsi:ERROR:CTLR num LUN num not attached 

Requested unit not present on controller. Check your system 
setup. 

scsi:ERROR:CTLR num LUN nwra:invalid type <num>, 

Requested unit is not a disk or tape. Disk and tape and printer 
are currently the only supported SCSI devices. 

scsi:ERROR:CTLR num LUN nwm:device not ready, ctlr, x); 
Requested device is busy. 

scsi:ERROR:adstrategy:device/type error Oxtype/Oxtype 

Internal error - open device is not disk, tape or printer. 

scsi:ERROR:adioctl:ADMODESENSE rc num host num unit num 
ioctl sense command did not complete as expected. 

scsi:WARNING:adioctl: ADEXECUTE rc num host num unit num 
ioctl execute command did not complete as expected. 

scsi:INFO:adioctl:n«m reassigned 

ioctl bad block mapping completed (done in pairs) 

scsi:WARNING:adsetparam:ADMODESENSE rc num host num unit 
num 

Mode sense command did not complete as expected. 

scsi:ERROR:adgetcdb:unsupported command num 
Internal error - unexpected command. 

scsi:WARNING:adintr:adapter num SR_DETECTED status=«wm, 
mtr=num 

SCSI reset detected. 

scsi:WARNING:Unexpected MBI status num 
Unexpected condition after interrupt. 

scsi:WARNING:ad_sndcmd:unexpected port status = num 
Unable to send command to adapter. 

scsi:ERROR:adpresent: Adapter num internal failureinwrn 
Adapter returned bad status on initialization. 

scsi:ERROR:on disk dev—num/num hsi—num id— num lun=num 
block-num sector=nwm, cylinder/head = num/num 
Disk I/O failure. 

scsi:ERROR:on tape ha-num id=num \\xn-num hst num ust num 
AHA-1540 cmd :num [num ...] 
AHA-1540 sense :num [num ...] 
Tape I/O failure; followed by one of these messages: 
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end of tape 

tape is write protected 
wrong record length 



Disk Driver Messages 

disk:ERROR:Diskinfo table overflow 

Too many disk drives in use - reconfigure kernel to increase the 
available number of disks. 

disk:ERROR:Invalid partition sector on hard disk 

Master boot block on disk is unrecognizable. Run fsck(C). 



Floppy Driver Messages 

floppy:WARNING:CMOS indicates no diskette drives installed 
Configuration memory invalid - run your DOS SETUP disk. 

floppy:WARNING:CMOS indicates diskette drive num not present 
Configuration memory invalid - run your DOS SETUP disk. 

floppy:ERROR:fd«wra being formatted 
The floppy drive is in use. 

floppy:ERROR:disk is write protected 

The disk cannot be written because it is protected. 

floppy:ERROR:on dev (num/num), block-num cmd=num status=nwm 
Floppy I/O failure, possibly followed by the message: 
insert disk or close floppy door 
if appropriate. 

floppy:WARNING:cmd result error 
I/O error on the floppy drive. 



VPIX Messages 

VPIXxommand completed unexpectedly 
Process terminated prematurely. 



OMTI Driver Messages 

omti:ERROR:cannot allocate a GDT descriptor 

Internal error - kernel dscralloc routine failed. 

omti:ERROR:unit=/2wm controller not configured 

Internal error - driver open failed to identify disk type. 
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omti:WARNING:already busy 

Internal error - omtistart called for a busy drive. 

omti:ERROR:unknown command(nwra), bp->b_cmd 

Internal error - omtistart encountered an unrecognized com- 
mand. 

omti:ERROR:command setup failed 

Controller failed to accept command. 

omti:WARNING:non-omti interrupt (num), omti_status 

Controller did not signal an interrupt when an interrupt was 
received. 

omti:WARNING:unexpected omti interrupt (num), omti_status 

Internal error - no pending command when interrupt received. 

omti:WARNING:still busy 

Controller still busy after generating an interrupt. 

omti:ERROR:during omti_sense 

Interrupt received during an OMTI sense command. 

omti:ERROR:initialization failure 

Error indicated during an initialization. 

omti:ERROR:sense command setup failed 

Controller failed to accept setup command. 

omti:ERROR:minor=«wm, block=n«ra, errtype=nwm, code=«wra, 
\mit=num [sector=nwm, cylinder/head=fl«m/num, ] <message> 
Disk I/O failure. <message> is one of: 

No error or no sense information, 
No Index, 

No Seek/Command Complete, 

Write/Drive Fault, 

Drive Not Selected/Not Ready, 

No Track zero or Cylinder zero found, 

Multiple Drives Selected, 

Seek/Command in progress, 

Cartridge Changed 

ID CRC, 

Uncorrectable Data ECC, 
ID Address Mark Not Found, 
Data Address Mark Not Found, 
Sector Not Found, 
Seek Error, 
Sequence/DMA, 
Write Protected, 
Correctable ECC, 
Bad Track Encountered, 
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Illegal Interleave Factor, 
Unknown Error, 

Ilegal Access To An Alternated Track/Unable to Read the Alternate 
Track Address, 

Alternate of Bad Track Already Assigned, 

No Alternate Track Found, 

Illegal Alternate Track Address 

Invalid Command, 

Illegal Disk Address, 

Illegal Function for Drive Type, 

Volume Overflow 

RAM error, 

EPROM Checksum/Internal Diagnostic error 
Error with unknown type or code 

omti: ERROR: controller already in select state 

Internal error - controller busy when sending command. 

omti:ERROR:cannot enter command phase 

Controller failed to accept select command. 

omti:ERROR:C_D bit stuck off 

Controller failed to indicate readiness for command. 

omti:ERROR:OMTI_BUSY bit still stuck on 
Controller failed to obey reset command. 

omti:INFO:unloading all requests 

Preparing for manual reset because programmed reset did not 
work. 

omti:WARNING:colliding polling routines ... 

Internal error - multiple instances of omtipoll. 

omti:ERROR:timed out 

Expected interrupt did not arrive. 

omti:ERROR:please use sfmt to modify disk parameters 

Attempt to write disk characteristics directly with DIOWDISK 
ioctl. 



Serial Driver Messages 

serial:ERROR:Garbage or loose cable on dev num, port shut down 

Too many interrupts were received together. Check your con- 
nections. 



Winchester Driver Messages 
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wd:ERROR:on fixed disk dev=num/num block=num cmd=num 
status=num sector=nwm, cylinder/head = num/num 
Disk I/O failure. 



Event Driver Messages 

event:ERROR:event channel full 

There are no more devices available in the event queue. 

event:ERROR:event table full 

All of the system's event queues are opened. 



Keyboard Driver Messages 

kb:ERROR:keyboard is in an unknown mode 

The keyboard has been set in an invalid mode through an ioctlQ. 
The only valid keyboard modes are XT (0) and AT(1). 



Notes 

Not all messages appear on all machines. Some messages are proces- 
sor dependent. 
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Name 

mscreen - Serial multiscreens utility 



Syntax 

mscreen [ -s ] [ -n number ] [ -t ] 



Description 

mscreen allows a serial terminal to have multiple login screens similar 
to the multiscreen(M) console. 

Note: For full mscreen support the terminal must have the ability to 
switch internal screen pages on command and it must retain a separate 
cursor position for each screen page. 

The options are used as follows: 

-s Silent mode. This flag suppresses the startup messages, 

and on "dumb" terminals it suppresses the screen switch 
messages 

-n Selects the number of serial multiscreens desired up to the 

maximum defined for the terminal type. 

-t Disables the transparent tty checking, mscreen normally 

exits silently if the terminal device name starts with the 
characters "ttyp". Device names beginning with "ttyp" 
are used as slave devices for mscreen. The correct names 
for the master tty devices begin with "ptyp". 

mscreen can be used on both "smart" and "dumb" terminals. 
Although it is optimized to take advantage of smart terminals with 
screen memory, mscreen also works on dumb terminals, although the 
screen images are not saved during screen changes, mscreen also sup- 
ports terminals with two (or more) serial ports that are connected to 
different computers. 

mscreen is designed to be invoked from the .profile or .login files. Use 
mscreen in place of the SHELL variable so that serial multiscreens 
can be automatic at login time. The "stop" and "quit" keys allow 
you to logout from all screens with a single keystroke. 



Configuration 

mscreen determines the terminal type of the terminal it is invoked 
from by examining the environment variable TERM, mscreen looks 
in /etc/mscreencap or in the filename contained in the environment 
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variable SPTTERMCAP to get the capabilities for the terminal type. 

The pseudo terminals assigned to the user are automatically deter- 
mined at startup by mscreen. Manual assignment of ttys can be 
accomplished by creating a file in the user's home directory called 
.mscreenrc. 



mscreencap format 

mscreencap contains an entry for each terminal type supported. An 
entry may have several names if the support for several terminal types 
are the same. Within an entry are the key mappings for each potential 
pseudo terminal. Each pseudo terminal has a help key string, an input 
string (the sequence generated by the key that selects this screen), and 
an optional output string (the sequence to send to the terminal that 
will cause a page switch). The input and output strings are in a 
termcap like format: (the backslash and caret are special lead in 
(escape) characters) 



\nnn 


an octal number, one to three digits are allowed 


\n 


newline 


V 


carriage return 


\t 


tab 


\b 


backspace 


\f 


form feed 


\E 


escape (hex lb octal 33). 


\ 


enter backslash as a data character 


V 


enter caret as a data character 


YX 


ctrl-X where X can be: @ABCDEFGHIJKLM- 




NOPQESTUVWXYZ[r_ effectively the caret 




can generate hex 01 through hex If. 



If a terminal type has no output strings then it is assumed to be a dumb 
terminal that does not have multiple internal memory pages. 

There are five special entries that allow the user to define keys to sup- 
port the other functions of mscreen. They are the help key (which 
prints a list of all of the keys that are currently available and their 
functions), the who key (prints the name of the current screen), the 
stop key (terminates mscreen and returns a good (zero) shell return 
code), and quit key (terminates mscreen and returns a bad (non-zero) 
shell return code and the dummy entry that is used for terminals with 
multiple ports. 

The format is: 

#this is a comment and may only appear between entries 
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entryname I alias 1 1 alias 1 . . . laliasn : 

:specialname,helpname,inputstring,pageselectstring: 

:specialname,helpname,inputstring,pageselectstring: 
entrynamelaliasl lalias 1 . ..laliasn: 

:specialname,helpname,inputstring,pageselectstring: 

:specialname,helpname,inputstring,pageselectstring: 

The specialname is empty for real screen entries. See the provided 
/etc/mscreencap for examples. 



.mscreenrc format 

a fixed set of ttys for use: 

ttypO 
ttypl 
ttypn 



Shell return codes and auto login/logout 

mscreen exits with a bad (non-zero) return code if there is an error or 
when the "quit" key is pressed. The "stop" key causes mscreen to 
exit with a good (zero) return code. This allows users to place mscreen 
in the .login or .profile files. The .login or .profile files should set up an 
automatic logout if the mscreen return code is good (zero). The fol- 
lowing is a csh sample invocation of mscreen for a .login file: 

mscreen -n 4 

if ($status == 0) logout 

The single key logout feature of mscreen works as if a normal logout 
was entered on each pseudo-terminal. A hangup signal is sent to all of 
the processes on all the pseudo terminals. 



Multiple Port Option 

mscreen provides a dummy entry type. It allows mscreen to be placed 
in an inactive state while the user uses his terminal to converse 
through another (physical) io port to another computer, see the pro- 
vided /etc/mscreentermmap for an example. To be used, you must 
take the example and configure it for your needs. 



mscreen Driver 

The mscreen driver is already installed in the XENIX kernel with eight 
pseudo terminals available for use. You must enable a pseudo termi- 
nals to use it. See the link-kit instructions for relinking the kernel to 
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have more available pseudo terminals. 



Notes 

mscreen has a VTIM timeout of 1/5 second for input strings. 

mscreen has a limit of twenty multiscreens per user. 

You should not switch screen pages in mscreen when output is occur- 
ing because if an escape sequence is cut in half it may leave the termi- 
nal in an indeterminate state and distort the screen image. 

Terminals that save the cursor location for each screen often do not 
save states such as insert mode, inverse video, and others. For exam- 
ple, you should not change screens if you are in insert mode in vi, and 
you should not change screens during an inverse video output 
sequence. 

For inactive screens (screens other than the current one) mscreen 
saves the last 2048 characters of data (2K). Data older than this is 
lost. This limit occasionally results in errors for programs that require 
a memory of more data than this. The user-defined screen redraw key 
restores the screen to normal appearance. 

mscreen depends on the pseudo terminal device names starting with 
ttyp for the slave devices and ptyp for the master devices. The number 
of trailing character in the device name is not significant. 



See Also 

multiscreen(M), enable(C) 
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Name 

multiscreen - Multiple screens (device files) 



Syntax 

alt-Fn 
alt-ctrl -Fn 
alt-shift-Fn 
alt-ctrl -shift-Fn 



Description 

With the multiscreen feature, a user can access up to twelve different 
"screens," each corresponding to a separate device file. Each screen 
can be viewed one at a time through the primary monitor video 
display. 

The number of screens on a system depends upon the amount of 
memory in the computer. The system displays the number of enabled 
screens during the boot process. 

Access 

To see the next consecutive screen, enter: 
Ctrl-PrtSc 

To move to any screen from any other screen, enter: 

alt-Fn or alt-ctrl -Fn or alt-shift-Fn 
alt-Fn or alt-ctrl -Fn (screens 1-12) 
alt-shift-Fn or alt-ctrl-shift-Fn (screens 11-16, 7-12) 

where n is the number of one of the "F" function keys on the primary 
monitor keyboard. For example: 

alt-F2 

selects tty02, and all output in that device's screen buffer is displayed 
on the monitor screen. 

The second form (using the SHIFT key) permits access to screens 1 1 
and 12 on keyboards that have only ten function keys. It is also possi- 
ble to configure the kernel for up to 16 screens, but 12 is the default. 

The function key combinations used to display the various screens are 
defined in the keyboard mapping file. The /usr/lib/key board/keys or 
other mapkey(ADM) file can be modified to allow different key com- 
binations to change multiscreens. Use the mapkey utility to create a 
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new keyboard map. 



Files 



/dev/tty[01-12] 



multiscreen devices 

(number available depends on system 

memory) 



See Also 



mapkey(ADM), keyboard(HW), screen(HW), serial(HW), stty(C) 



Any system error messages are normally output on the console device 
file (/dev/console). When an error message is output, the video 
display reverts to the console device file, and the message is displayed 
on the screen. The console device is the only teletype device open 
during the system boot sequence and when in single user, or system 
maintenance mode. 

Limitations to the number of multiscreens available on a system does 
not affect the number of serial lines or devices available. See 
serial (M) for information on available serial devices. 

Note that the keystrokes given here are the default for XENIX, but 
your keyboard may be different. If so, see keyboardQA) for the 
appropriate substitutes. Also, any key can be programmed to generate 
the screen switching sequences by using the mapkey utility. 



Notes 



May 16, 1988 



Page 2 



PROFILE (M) 



PROFILE (M) 



Name 

profile - Sets up an environment at login time. 



Description 

The optional file, .profile, permits automatic execution of commands 
whenever a user logs in. The file is generally used to personalize a 
user's work environment by setting exported environment variables 
and terminal mode (see environ(C)). 

When a user logs in, the user's login shell looks for .profile in the 
login directory. If found, the shell executes the commands in the file 
before beginning the session. The commands in the file must have the 
same format as if they were entered at the keyboard. Any line begin- 
ning with the number sign (#) is considered a comment and is ignored. 
The following is an example of a typical file: 

# Tell me when new mail comes in 
MAIL=/usr/mail/myname 

# Add my /bin directory to the shell search sequence 
P ATH=$P ATH : $HOME/bin 

# Make some environment variables global 
export MAIL PATH TERM 

# Set file creation mask 
umask 22 

Note that the file /etc/profile is a system- wide profile that, if it exists, 
is executed for every user before the user's .profile is executed. 



Files 

$HOME/.profile 
/etc/profile 



See Also 

env(C), login(M), mail(C), sh(C), stty(C), su(C), environ(M) 
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Name 

sxt - Pseudo-device driver 



Description 

Sxt is a pseudo-device driver that interposes a discipline between the 
standard tty line disciplines and a real device driver. The standard dis- 
ciplines manipulate virtual tty structures (channels) declared by the 
sxt driver. Sxt acts as a discipline manipulating a real tty structure 
declared by a real device driver. The sxt driver is currently only used 
by the shl(C) command. 

Virtual ttys are named /dev/sxt??? and are allocated in groups of up 
to eight. To allocate a group, a program should exclusively open a file 
with a name of the form /dev/sxt??0 (channel 0) and then execute a 
SXTIOCLINK ioctl call to initiate the multiplexing. 

Only one channel, the controlling channel, can receive input from the 
keyboard at a time; others attempting to read will be blocked. 

There are two groups of ioctl (S) commands supported by sxt. The 
first group contains the standard ioctl commands described in 
termio (M), with the addition of the following: 

TIOCEXCL Set exclusive use mode: no further opens are permit- 
ted until the file has been closed. 

TIOCNXCL Reset exclusive use mode: further opens are once 
again permitted. 

The second group are directives to sxt itself. Some of these may only 
be executed on channel 0. 

SXTIOCLINK Allocate a channel group and multiplex the 
virtual ttys onto the real tty. The argument is 
the number of channels to allocate. This com- 
mand may only be executed on channel 0. 
Possible errors include: 

EINVAL The argument is out of range. 

ENOTTY The command was not issued from a 
real tty. 

ENXIO linesw is not configured with sxt. 

EBUSY An SXTIOCLINK command has 
already been issued for this real tty. 
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ENOMEM 

There is no system memory avail- 
able for allocating the virtual tty 
structures. 



EBADF Channel was not opened before 
this call. 



SXTIOCSWTCH Set the controlling channel. Possible errors 
include: 



EINVAL An invalid channel number was 
given. 

EPERM The command was not executed 
from channel 0. 



SXTIOCWF Cause a channel to wait until it is the control- 

ling channel. This command will return the 
error, EINVAL, if an invalid channel number is 
given. 

SXTIOCUBLK Turn off the loblk control flag in the virtual tty 
of the indicated channel. The error EINVAL 
will be returned if an invalid number or chan- 
nel is given. 

SXTIOCSTAT Get the status (blocked on input or output) of 
each channel and store in the sxtblock structure 
referenced by the argument. The error 
EFAULT will be returned if the structure can- 
not be written. 



SXTIOCTRACE Enable tracing. Tracing information is written 
to the console. This command has no effect if 
tracing is not configured. 



SXTIOCNOTRACE Disable tracing. This command has no effect if 
tracing is not configured. 



FILES 

/dev/sxt??[0-7] virtual tty devices 

/usr/include/sys/sxt.h driver specific definitions 



SEE ALSO 

shl(C), stty(C), ioctl(S), open(S), termio(M) 
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Name 

systty - System maintenance device. 
Description 

The file /dev/systty is the device on which system error messages are 
displayed. The actual physical device accessed via /dev/systty is 
selected during boot, and is typically the device used to control the 
bootup procedure. The default physical device /dev/systty is deter- 
mined by boot (HW) when the system is brought up. 

Initially /dev/console is linked to /dev/systty. 

Files 

/dev/systty 

See Also 

boot(HW), console(M) 
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Name 

termcap - Terminal capability data base. 



Description 

The file /etc/termcap is a data base describing terminals. This data 
base is used by commands such as v/(C), vsh(C), Lyrix , Multiplan tm 
and sub-routine packages such as curses (S). Terminals are described 
in termcap by giving a set of capabilities and by describing how 
operations are performed. Padding requirements and initialization 
sequences are included in termcap. 

Entries in termcap consist of a number of fields separated by colons 
':'. The first entry for each terminal gives the names that are known 
for the terminal, separated by vertical bars ( I ). For compatibility 
with older systems the first name is always 2 characters long. The 
second name given is the most common abbreviation for the terminal 
and the name used by vi (C) and ex(C). The last name given should be 
a long name fully identifying the terminal. Only the last name can 
contain blanks for readability. 



Capabilities (including XENIX Extensions) 

The following is a list of the capabilities that can be defined for a 
given terminal. In this list, (P) indicates padding can be specified, and 
(P*) indicates that padding can be based on the number of lines 
affected. The capability type and padding fields are described in 
detail in the following section "Types of Capabilities. " 

The codes beginning with uppercase letters (except for CC) indicate 
XENIX extensions. They are included in addition to the standard 
entries and are used by one or more application programs. As with the 
standard entries, not all modes are supported by all applications or ter- 
minals. Some of these entries refer to specific terminal output capa- 
bilities (such as GS for "graphics start"). Others describe character 
sequences sent by keys that appear on a keyboard (such as PU for 
PageUp key). There are also entries that are used to attribute special 
meanings to other keys (or combinations of keys) for use in a particu- 
lar software program. Some of the XENIX extension capabilities have 
a similar function to standard capabilities. They are used to redefine 
specific keys (such as using function keys as arrow keys). The exten- 
sion capabilities are included in the /etc/termcap file, as they are 
required for some XENIX utilities (such as vsh(C)). The more com- 
monly used extension capabilities are described in more detail in the 
section ' 'XENIX Extensions. ' ' 
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Name 


Type Pad? Description 


ae 


str 


(P) 


End alternate character set 


al 


str 


(P*) 


Add new blank line 


am 


bool 




Terminal has automatic margins 


as 


str 


(P) 


Start alternate character set 


be 


str 




Backspace if not "H 


bs 


bool 




Terminal can backspace with "H 


bt 


str 


(P) 


Back tab 


bw 


bool 


Backspace wraps from column 








to last column 


CC 


str 




Command character in prototype 








if terminal settable 


cd 


str 


(P*) 


Clear to end of display 


ce 


str 


(P) 


Clear to end of line 


CF 


str 


Cursor off 


ch 


str 


(P) 


Like cm but horizontal motion only, 








line stays same 


CL 


str 




Sent by CHAR LEFT key 


cl 


str 


(P*) 


Clear screen 


cm 


str 


(P) 


Cursor motion 


CO 


num 


Number of columns in a line 


CO 


str 




Cursor on 


cr 


str 


(P*) 


Carriage return, (default *M) 


cs 


str 


(P) 


Change scrolling region (vtl00),4ike cm 


cv 


str 


(P) 


Like ch but vertical only. 


CW 


str 




Sent by CHANGE WINDOW key 


da 


bool 




Display may be retained above 


DA 


bool 




Delete attribute string 


db 


bool 




Display may be retained below 


dB 


num 




Number of millisec of bs delay needed 


dC 


num 




Number of millisec of cr delay needed 


dc 


str 


(P*) 


Delete character 


dF 


num 


Number of millisec of ff delay needed 


dl 


str 


(P*) 


Delete line 


dm 


str 


Delete mode (enter) 


dN 


num 




Number of millisec of nl delay needed 


QO 


str 




Down one line 


dT 


num 




Number of millisec of tab delay needed 


ed 


str 




End delete mode 


ei 


str 




End insert mode; give v :ei=: ' 
if ic 


EN 


str 




Sent by END key 


eo 


bool 




Can erase overstrikes with a blank 


ff 


str 


(P*) 


Hardcopy terminal page eject (default X) 


Gl 


str 




Upper-right (1st quadrant) corner character 


G2 


str 




Upper-left (2nd quadrant) corner character 



May 16, 1988 



Page 2 



TERMCAP (M) 



TERMCAP (M) 



Name 


Type Pad? Description 


G3 


str 




T ower-left f^rd nnadrant^ rnrnpr character 


G4 


str 




T ower-ricrht f4th nnadrant^ rnrnpr character 

JLA/WW llz^lil. \ > 111 \11XCL\XL (XllL J t-vl llwl Wli£li dW LWl 


GC 


str 




Center !?rar)hics character (similar to "+"^ 

V — - W i X L fcJL CCLyillWiJ Wll.CUCt.WLwX lOAXllllCU 1 f 


GD 


str 




Down-tick character 


GE 


str 




Graphics mode end 


GG 


num 




Niimher of chars taken bv GS and (TF 

1 1 U111UW1 VSJt. W11C11 O LCUX.W11 Y ' — i V-J ClllU V J J / 


GH 


str 




Hori7ontal bar character 

1 Ivl l£jUili(U CCU W11C1X Clvlvl 


GL 


str 




Left-tick character 


GR 


str 




Right-tick character 


GS 


str 




Graphics mode start 


GU 


str 




Up-tick character 


GV 


str 




Vertical bar character 


he 


bool 




Hardcopy terminal 


hd 


str 




Half-line down (forward 1/2 linefeed) 


HM 


str 




Sent by HOME key (if not kh) 


ho 


str 




Home cursor (if no rml 

XXwlllW vlliavl V.-'"'- XI\J win/ 


hu 


str 




Half-line up (reverse 1/2 linefeed) 


hz 


str 




Ha7eltine* can't nrint 's 

X XCl£jWAlXllw, WCU1 L L/llAAl- ij 


ic 


str 


(P} 


Tnsert character 

JLXlowl L wlicll CXwLwl 


if 


str 




Name of file containing is 

x 'i cuuw \si xixw vuiii-cuimig u 


im 


str 




Insert mode (enter); give ':im=' if ic 


in 


bool 




Insert mode distinguishes nulls on display 


ip 


str 




Insert pad after character inserted 


is 


str 




Terminal initialization string 


k0-k9 


str 




Sent by 'other' function keys 0-9 


kb 


str 




Sent by backspace key 


kd 


str 




Sent by terminal down arrow key 


ke 


str 




Out of 'keypad transmit' mode 


kh 


str 




Sent by home key 


kl 


str 




Sent by terminal left arrow key 


kn 


num 




Number of 'other' keys 


ko 


str 




Termcap entries for other non-function keys 


kr 


str 




Sent by terminal right arrow key 


ks 


str 




Put terminal in 'keypad transmit' mode 


ku 


str 




Sent hv terminal un arrow kev 

uviil w y iwiinxiicu uu chivvy ivwy 


10-19 


str 




Labels on 'other' function keys 


LD 


str 




Sent bv line delete kev 

Uwlll J xxxiw Uvlvlv ivwy 


LF 


str 




Sent by line feed key 


li 


num 




Number of lines on screen or page 


11 


str 




Last line, first column (if no cm) 


ma 


str 




Arrow key map, used by vi version 2 only 


mi 


bool 




Safe to move while in insert mode 


ml 


str 




Memory lock on above cursor 


MP 


str 




Multiplan initialization string 


MR 


str 




Multiplan reset string 


ms 


bool 




Will scroll in stand-out mode 


mu 


str 




Memory unlock (turn off memory lock) 
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Name 


lype 


Pad? Description 


nc 


DOOl 




No correctly working carriage return 
(DM2500,H2000) 


nd 


str 




Non-destructive space (cursor right) 


nl 


str 


(P*) 


Newluie character (default \n) 


ns 


bool 




Terminal is a CRT but doesn't scroll 


"MT T 


str 




Sent by NEXT UNLOCKED CELL key 


OS 


bool 




Terminal overstrikes 


pc 


str 




Pad character (rather than null) 


PD 


str 




Sent by PAGE DOWN key 


n\l 

rlN 


str 




Start local printing 


DC 

Jro 


str 




End local printing 


Pt 


bool 




Has hardware tabs 






(may need to be set with is) 


dt t 


str 




Sent by PAGE UP key 


RC 


str 




Sent by RECALC key 


Kr 


str 




Sent by TOGGLE REFERENCE key 


Kl 


str 




Sent by RETURN key 


se 


str 




End stand out mode 


SI 


str 


(P) 


Scroll forwards 


sg 


num 




"XT t f* 1 1 1 1 If. 1 

Number of blank chars left by so or se 


so 


str 




Begin stand out mode 


sr 


str 


(P) 


Scroll reverse (backwards) 


to 

la 


str 


(P) 


Tab (other than 1 or with padding) 


tc 


str 




Entry of similar terminal - must be last 


te 


str 




String to end programs that use cm 


ti 


str 




String to begin programs that use cm 


uc 


str 




Underscore one char and move past it 


ue 


str 




End underscore mode 


u g 


num 




Number of blank chars left by us or ue 


nl 
Ul 


bool 




Terminal underlines even though 
it doesn't overstrike 


up 


str 




Upline (cursor up) 


TTP 
Ur 


str 




Sent by up-arrow key (alternate to ku) 


us 


str 




Start underscore mode 


VD 


str 




Visible bell (may not move cursor) 


ve 


str 




Sequence to end open/visual mode 


vs 


Off 

sir 




Sequence to start open/visual mode 


WL 


str 




Sent by word Lbr 1 key 


VV Iv 


str 




Sent by WORD RIGHT key 


xb 


bool 




Beehive (tl=escape, i2=ctrl C) 


xn 


bool 




A newline is ignored after a wrap 
(Concept) 


xr 


bool 




Return acts like ce \r \n 

\UcLld Uald) 


xs 


bool 




Standard out not erased by writing over it 
(HP 264?) 


xt 


bool 




Tabs are destructive, magic so char 
(Teleray 1061) 
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A Sample Entry 

The following entry describes the Concept- 100, and is among the 
more complex entries in the termcap file. (This particular Concept 
entry is outdated, and is used as an example only.) 

cl I clOO I concept 100:is=\EU^ENE7JE5\E8\EI\ENH\EK\B^00\Eo&\200:\ 
:al=3*\E"R:am:bs:cd=16*VE A C:ce=16^E A S:cl=2*"L:\ 
:cm=\Ea%+ %+ :co#80:dc=16\E A A:dl=3*\E A B:\ 
:ei=\EN200:eo:im=\ET:in:ip=16*:li#24:mi:nd=\E=:\ 
:se=\Ed\Ee:so=\ED\EE:ta=8\t:ul:up=\E;:vb=\Ek\EK:xn: 

Entries may continue over to multiple lines by giving a backslash (\) 
as the last character of a line. Empty fields can be included for reada- 
bility between the last field on a line and the first field on the next. 
Capabilities in termcap are of three types: Boolean capabilities, 
which indicate that the terminal has some particular feature, numeric 
capabilities giving the size of the terminal or the size of particular 
delays, and string capabilities, which give a sequence that can be used 
to perform particular terminal operations. 

Types of Capabilities 

All capabilities have two letter codes. For instance, the fact that the 
Concept has 'automatic margins' (i.e., an automatic return and 
linefeed when the end of a line is reached) is indicated by the capabil- 
ity am. The description of the Concept includes am. Numeric capa- 
bilities are followed by the character '#' and then the value. Thus co, 
which indicates the number of columns the terminal has, gives the 
value '80' for the Concept. 

Finally, string valued capabilities, such as ce (clear to end of line 
sequence) are given by the two character code, an '=', and then a 
string ending at the next following ':'. A delay in milliseconds may 
appear after the '=' in such a capability, and padding characters are 
supplied by the editor after the rest of the string is sent to provide this 
delay. The delay can be either a integer, e.g., '20', or an integer fol- 
lowed by an '*', i.e. '3*'. A '*' indicates that the padding required is 
proportional to the number of lines affected by the operation, and the 
amount given is the per-affected-unit padding required. When a '*' is 
specified, it is sometimes useful to give a delay of the form '3.5' to 
specify a delay per unit to tenths of milliseconds. 

A number of escape sequences are provided in the string valued capa- 
bilities for easy encoding of characters there. A \E maps to an ESCAPE 
character, A x maps to a control-x for any appropriate x, and the 
sequences \n \r \t \b \f give a newline, return, tab, backspace and 
formfeed. Finally, characters may be given as three octal digits after a 
\, and the characters A and \ may be given as \ A and \\. If it is necessary 
to place a colon (:) in a capability, it must be escaped in octal as \072. 
If it is necessary to place a null character in a string capability, it must 
be encoded as \200. The routines that deal with termcap use C strings, 
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and strip the high bits of the output very late so that a \200 comes out 
as a \000 would. 

Preparing Descriptions 

The most effective way to prepare a terminal description is by imitat- 
ing the description of a similar terminal in termcap and to build up a 
description gradually, using partial descriptions with ex to check that 
they are correct. Be aware that a very unusual terminal may expose 
deficiencies in the ability of the termcap file to describe it. To test a 
new terminal description, you can set the environment variable 
TERMCAP to a pathname of a file containing the description you are 
working on and the editor will look there rather than in /etc/termcap. 
TERMCAP can also be set to the termcap entry itself to avoid reading 
the file when starting up the editor. 

Basic capabilities 

The number of columns on each line for the terminal is given by the 
co numeric capability. If the terminal is a CRT, the number of lines on 
the screen is given by the li capability. If the terminal wraps around to 
the beginning of the next line when it reaches the right margin, it 
should have the am capability. If the terminal can clear its screen, 
this is given by the cl string capability. If the terminal can backspace, 
it should have the bs capability, unless a backspace is accomplished 
by a character other than "H in which case you should give this char- 
acter as the be string capability. If it overstrikes (rather than clearing a 
position when a character is struck over), it should have the os capa- 
bility. 

A very important point here is that the local cursor motions encoded in 
termcap are undefined at the left and top edges of a CRT terminal. The 
editor will never attempt to backspace around the left edge, nor will it 
attempt to go up locally off the top. The editor assumes that feeding 
off the bottom of the screen will cause the screen to scroll up, and the 
am capability tells whether the cursor sticks at the right edge of the 
screen. If the terminal has switch selectable automatic margins, the 
termcap file usually assumes that this is on (i.e., am). 

These capabilities suffice to describe hardcopy and 'glass-tty' termi- 
nals. Thus the model 33 teletype is described as 

t3l33ltty33:co#72:os 

while the Lear Siegler ADM-3 is described as: 

cl I adm3l3llsi adm3:am:bs:cl="Z:li#24:co#80 
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Cursor addressing 

Cursor addressing in the terminal is described by a cm string capabil- 
ity. This capability uses printf(S) like escapes (such as %x) in it. 
These substitute to encodings of the current line or column position, 
while other characters are passed through unchanged. If the cm string 
is thought of as being a function, its arguments are the line and then 
the column to which motion is desired, and the % encodings have the 



following meanings: 


Ot A 


replaced by line/column position, origin 


/O L 


luce /ozci - z uigu neici 


%3 


like %3d - 3 digit field 


%. 


like printf(S) %c 


%+x 


adds x to value, then %. 


%>xy 


if value > x adds y, no output 


%r 


reverses order of line and column, no output 


%i 


increments line/column position (for 1 origin) 


%% 


gives a single % 


%n 


exclusive or row and column with 0140 




(DM2500) 


%B 


BCD (16*(x/10)) + (x%10), no output 


%D 


Reverse coding (x-2*(x%16)), no output 




(Delta Data). 



Consider the HP2645, which, to get to row 3 and column 12, needs to 
be sent \E&al2c03Y padded for 6 milliseconds. Note that the order of 
the rows and columns is inverted here, and that the row and column 
are printed as two digits. Thus its cm capability is 
'cm=6\E&%r%2c%2Y\ The Microterm ACT-IV needs the current row 
and column sent preceded by a T, with the row and column simply 
encoded in binary, 'cm=T%.%.'. Terminals that use '%.' need to be 
able to backspace the cursor (bs or be), and to move the cursor up one 
line on the screen (up introduced below). This is necessary because it 
is not always safe to transmit \t, \n "D and \r, as the system may 
change or discard them. 

A final example is the LSI ADM-3a, which uses row and column offset 
by a blank character, thus 'cm=\E=%+ %+ '. 

Cursor motions 

If the terminal can move the cursor one position to the right, leaving 
the character at the current position unchanged, this sequence should 
be given as nd (non-destructive space). If it can move the cursor up a 
line on the screen in the same column, it should be given as up. If the 
terminal has no cursor addressing capability, but can home the cursor 
(to very upper left corner of screen), this can be given as ho; similarly, 
a fast way of getting to the lower left hand corner can be given as II; 
this may involve going up with up from the home position, but the 
editor will never do this itself (unless 11 does) because it makes no 
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assumption about the effect of moving up from the home position. 
Area clears 

If the terminal can clear from the current position to the end of the 
line, leaving the cursor where it is, the sequence should be given as ce. 
If the terminal can clear from the current position to the end of the 
display, the sequence should be given as cd. The editor only uses cd 
from the first column of a line. 

Insert/delete line 

If the terminal can open a new blank line before the line where the 
cursor is, the sequence should be given as al. Note that this is done 
only from the first position of a line. The cursor must then appear on 
the newly blank line. If the terminal can delete the line on which the 
cursor rests, the sequence should be given as dl. This is done only 
from the first position on the line to be deleted. If the terminal can 
scroll the screen backwards, the sequence can be given as sb, but al 
can suffice. If the terminal can retain display memory above, the da 
capability should be given, and if display memory can be retained 
below, then db should be given. These let the editor know that delet- 
ing a line on the screen may bring non-blank lines up from below or 
that scrolling back with sb may bring down non-blank lines. 

Insert/delete character 

There are two basic kinds of intelligent terminals with respect to the 
insert/delete character that can be described using termcap. The most 
common insert/delete character operations affect only the characters 
on the current line and shift characters off the end of the line. Other 
terminals, such as the Concept 100 and the Perkin Elmer Owl, make a 
distinction between typed and untyped blanks on the screen, shifting 
upon an insert or delete only to an untyped blank on the screen which 
is either eliminated, or expanded to two untyped blanks. You can find 
out which kind of terminal you have by clearing the screen and enter- 
ing text separated by cursor motions. Enter 'abc def, using local 
cursor motions (not spaces) between the 'abc' and the 'def. Then 
position the cursor before the 'abc' and put the terminal in insert 
mode. If entering characters causes the rest of the line to shift rigidly 
and characters to fall off the end, your terminal does not distinguish 
between blanks and untyped positions. If the 'abc' shifts over to the 
'def which then move together around the end of the current line and 
onto the next as you insert, you have the second type of terminal, and 
should give the capability in, which stands for 'insert null'. No known 
terminals have an insert mode, not falling into one of these two 
classes. 

The editor can handle both terminals that have an insert mode and ter- 
minals that send a simple sequence to open a blank position on the 
current line. Specify im as the sequence to get into insert mode, or 
give it an empty value if your terminal uses a sequence to insert a 
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blank position. Specify ei as the sequence to leave insert mode 
(specify this with an empty value if you also gave im an empty value). 
Now specify ic as any sequence needed to be sent just before sending 
the character to be inserted. Most terminals with a true insert mode 
will not support ic, terminals that send a sequence to open a screen 
position should give it here. (Insert mode is preferable to the sequence 
to open a position on the screen if your terminal has both.) If post 
insert padding is needed, give this as a number of milliseconds in ip (a 
string option). Any other sequence that may need to be sent after an 
insert of a single character may also be given in ip. 

It is occasionally necessary to move around while in insert mode to 
delete characters on the same line (e.g., if there is a tab after the inser- 
tion position). If your terminal allows motion while in insert mode, 
you can give the capability mi to speed up inserting in this case. Omit- 
ting mi will affect only speed. Some terminals (notably Datamedia's) 
must not have mi because of the way their insert mode works. 

Finally, you can specify delete mode by giving dm and ed to enter and 
exit delete mode, and dc to delete a single character while in delete 
mode. 

Highlighting, underlining, and visible bells 

If your terminal has sequences to enter and exit standout mode, these 
can be given as so and se respectively. If there are several flavors of 
standout mode (such as reverse video, blinking, or underlining - half 
bright is not usually an acceptable 'standout' mode unless the terminal 
is in reverse video mode constantly), the preferred mode is reverse 
video by itself. It is acceptable, if the code to change into or out of 
standout mode leaves one, or even two blank spaces on the screen, as 
the TVI 912 and Teleray 1061 do. Although it may confuse some pro- 
grams slightly, it cannot be helped. 

Codes to begin underlining and end underlining can be given as us, 
and ue respectively. If the terminal has a code to underline the current 
character and move the cursor one space to the right, such as the 
Microterm Mime, the sequence can be given as uc. (If the underline 
code does not move the cursor to the right, specify the code followed 
by a nondestructive space.) 

If the terminal has a way of flashing the screen to indicate an error 
quietly (a bell replacement), the sequence can be given as vb; it must 
not move the cursor. If the terminal should be placed in a different 
mode during open and visual modes of ex, the sequence can be given 
as vs and ve, sent at the start and end of these modes respectively. 
These can be used to change from a underline to a block cursor and 
back. 

If the terminal needs to be in a special mode when running a program 
that addresses the cursor, the codes to enter and exit this mode can be 
given as ti and te. This arises, for example, from terminals like the 
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Concept with more than one page of memory. If the terminal has only 
memory relative cursor addressing and not screen relative cursor 
addressing, a one screen-sized window must be fixed into the terminal 
for cursor addressing to work properly. 

If your terminal correctly generates underlined characters (with no 
special codes needed), even though it does not overstrike, you should 
give the capability ul. If overstrikes are erasable with a blank, this 
should be indicated by specifying eo. 

Keypad 

If the terminal has a keypad that transmits codes when the keys are 
pressed, this information can be given. Note that it is not possible to 
handle terminals where the keypad only works in local (this applies, 
for example, to the unshifted HP 2621 keys). If the keypad can be set 
to transmit or not to transmit, enter these codes as ks and ke. Other- 
wise, the keypad is assumed always to transmit. The codes sent by the 
left arrow, right arrow, up arrow, down arrow, and home keys can be 
given as kl, kr, ku, kd, and kh. If there are function keys such as fO, 
fl, f9, the codes they send can be given as kO, kl, k9. If these 
keys have labels other than the default fO through f9, the labels can be 
given as 10, 11, 19. If there are other keys that transmit the same 
code as the terminal expects for the corresponding function, such as 
clear screen, the termcap 2 letter codes can be given in the ko capabil- 
ity, for example, ':ko=cl,ll,sf,sb:', which says that the terminal has 
clear, home down, scroll down, and scroll up keys that transmit the 
same thing as the cl, 11, sf, and sb entries. 

The ma entry is also used to indicate arrow keys on terminals which 
have single character arrow keys. It is obsolete, but still in use in ver- 
sion 2 of vi, which must be run on some minicomputers due to 
memory limitations. This field is redundant with kl, kr, ku, kd, and 
kh. It consists of groups of two characters. In each group, the first 
character is what an arrow key sends, the second character is the 
corresponding vi command. These commands are h for kl, j for kd, k 
for ku, 1 for kr, and H for kh. For example, the Mime would be 
:ma= A Kj A Zk A Xl: indicating arrow keys left (H), down ( A K), up (~Z), 
and right ( A X). (There is no home key on the Mime.) 

Miscellaneous 

If the terminal requires other than a null (zero) character as a pad, this 
can be given as pc. 

If tabs on the terminal require padding, or if the terminal uses a char- 
acter other than 1 to tab, the sequence can be given as ta. 

Terminals that do not allow '"' characters to be displayed (such as 
Hazeltines), should indicate hz. Datamedia terminals that echo 
carriage-return-linefeed for carriage return, and then ignore a follow- 
ing linefeed, should indicate nc. Early Concept terminals, that ignore 



May 16, 1988 



Page 10 



TERMCAP (M) 



TERMCAP (M) 



a linefeed immediately after an am wrap, should indicate xn. If an 
erase-eol is required to get rid of standout (instead of merely writing 
on top of it), xs should be given. Teleray terminals, where tabs turn all 
characters moved over to blanks, should indicate xt. Other specific 
terminal problems may be corrected by adding more capabilities of 
the form xx. 

If the leading character for commands to the terminal (normally the 
escape character) can be set by the software, specify the command 
character(s) with the capability CC. 

Other capabilities include is, an initialization string for the terminal, 
and if, the name of a file containing long initialization strings. These 
strings are expected to properly clear and then set the tabs on the ter- 
minal, if the terminal has settable tabs. If both are given, is is 
displayed before if. This is useful where if is /usr/lib/tabset/std , but 
is clears the tabs first. 

Similar Terminals 

If there are two very similar terminals, one can be defined as being 
just like the other with certain exceptions. The string capability, tc, 
can be given with the name of the similar terminal. This capability 
must be last and the combined length of the two entries must not 
exceed 1024. Since termlib routines search the entry from left to right, 
and since the tc capability is replaced by the corresponding entry, the 
capabilities given at the left override the ones in the similar terminal. 
A capability can be cancelled with xx@ where xx is the capability. 
For example: 

hn 1 262 1 nl:ks@ :ke@ : tc=262 1 : 

This defines a 262 lnl that does not have the ks or ke capabilities, and 
does not turn on the function key labels when in visual mode. This is 
useful for different modes for a terminal, or for different user prefer- 
ences. 

XENIX Extensions 

Capabilities This table lists the (previously listed) XENIX extensions 
to the termcap capabilities. It shows which codes generate information 
input from the keyboard to the program reading the keyboard and 
which codes generate information output from the program to the 
screen. 
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Name 


Input/ OutputDescription 


CF 


str 


Cursor off 


CL 


str 


Sent by CHAR LEFT key 


CO 


str 


Cursor on 


CW 


str 


Sent by CHANGE WINDOW key 


DA 


bool 


Delete attribute string 


EN 


str 


Sent by END key 


Gl 


str 


Upper-right (1st quadrant) corner character 


G2 


str 


Upper-left (2nd quadrant) corner character 


G3 


str 


Lower-left (3rd quadrant) corner character 


G4 


str 


Lower-right (4th quadrant) corner character 


GC 


str 


Center graphics character (similar to +) 


GD 


str 


Down-tick character 


GE 


str 


Graphics mode end 


GG 


num 


Number of chars taken by GS and GE 


GH 


str 


Horizontal bar character 


GL 


str 


Left-tick character 


GR 


str 


Right-tick character 


GS 


str 


Graphics mode start 


GU 


str 


Up-tick character 


GV 


str 


Vertical bar character 


HM 


str 


Sent by HOME key (if not kh) 


MP 


str 


Multiplan initialization string 


MR 


str 


Multiplan reset string 


NU 


str 


Sent by NEXT UNLOCKED CELL key 


PD 


str 


Sent by PAGE DOWN key 


PU 


str 


Sent by PAGE UP key 


RC 


str 


Sent by RECALC key 


RF 


str 


Sent by TOGGLE REFERENCE key 


RT 


str 


Sent by RETURN key 


UP 


str 


Sent by up-arrow key (alternate to ku) 


WL 


str 


Sent by WORD LEFT key 


WR 


str 


Sent by WORD RIGHT key 



Cursor motion Some application programs make use of special editing 
codes. CR and CL move the cursor one character right and left 
respectively. WR and WL move the cursor one word right and left 
respectively. CW changes windows, when they are used in the pro- 
gram. 

Some application programs turn off the cursor. This is accomplished 
using CF for cursor off and CO to turn it back on. 

Graphic mode. If the terminal has graphics capabilities, this mode 
can be turned on and off with the GS and GE codes. Some terminals 
generate graphics characters from all keys when in graphics mode 
(such as the Visual 50). The other G codes specify particular graphics 
characters accessed by escape sequences. These characters are avail- 
able on some terminals as alternate graphics character sets (not as a 
bit-map graphic mode). The vtlOO has access to this kind of alternate 
graphics character set, but not to a bit-map graphic mode. 
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Files 

/etc/termcap File containing terminal descriptions 



See Also 

ex(C), curses(S), termcap(S), tset(C), vi(C), more(C), screen(HW) 



Credit 

This utility was developed at the University of California at Berkeley 
and is used with permission. 



Notes 

ex(C) allows only 256 characters for string capabilities, and the rou- 
tines in termcap(S) do not check for overflow of this buffer. The total 
length of a single entry (excluding only escaped newlines) may not 
exceed 1024. 

The ma, vs, and ve entries are specific to the vz (C) program. 

Not all programs support all entries. There are entries that are not 
supported by any program. 

XENIX termcap extensions are explained in detail in the software 
application documentation. 

Refer to the screen (HW) manual page, for a description of the charac- 
ter sequences used by the monitor device on your specific XENIX Sys- 
tem. 
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Name 

terminals - List of supported terminals. 



Description 

The following list, derived from the file /etc/termcap, shows the ter- 
minal name (suitable for use as a TERM shell variable), and a short 
descsription of the terminal. The advice in termcap(M) will assist 
users in creating termcap entries for terminals not currently supported. 



Name 


Terminal 


33 


model 33 teletype 


37 


model 37 teletype 


43 


model 43 teletype 


300 


terminet 300 


1200 


terminet 1200 


1620 


diablo 1620 


1640 


diablo 1640 


2392 


239x series 


2392an 


hp 239x in ansi mode 


2392ne 


239x series 


2621 


hp 2621 


2621k45 


hp 2621 with 45 keyboard 


2621nl 


hp 2621 with no labels 


262 lnt 


hp 2621 w/notabs 


2621wl 


hp 2621 with labels 


2622 


hp 2622 


262x 


hp 262x series 


2640 


hp 2640a 


2640b 


hp 264x series 


3045 


datamedia 3045a 


3151 


ibm3151 


3161 


ibm3161 


3163 


ibm3163 


3164 


ibm3164 


4025 


Tektronix 4024/4025/4027 


4025-17 


Tek 4025 17 line window 


4025- 17ws 


tek 4025 17 line window in workspace 


4025ex 


Tek 4025 


5425 


AT&T Teletype 5425 


5425-w 


AT&T Teletype 5425 with 132 columns 


7900 


NCR 7900-1 


8001 


ISC8001 


912b 


new Televideo 


925 


newer Televideo 
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npw/pr TpIpa/i r\p*r\ xx/ith attfihntp hrvtp \x/nr1rarrvimd 
11CWC1 1C1CV1U.CU Willi ctlLllUUtC L/jLC WOll^cllLlUllU. 


Ma9 


Arnnpv IMndpl 9^9 with 1^9 linpo. 

.rYlllJJCA 1V1UU.C1 jLDZ, Willi 1J)Z. HllCo 


TWO 

1 VV Ks 


Altr\c r^r^mTMi tAf ^kvotpmc TT 
/VllUo V^-UllipULCl OyolCllio 11 




addc. pnnenl 080 

ailU-o dJllolil yO\J 


aa 


Ann Arhrvr 


3.3.3. 


Ann Arhrvr Atrih;}<;<:fidrvr/4.R 1inp<5 


a.a.a,30 


Ann Arbor Ambassador 30/destructive backspace 


flflfldh 


Ann Arhrvr ATTihassAdnr 48/dp^tniPtivp hflplcsnapp 




Ann A rhr\r A mhaco a dnr zlR /dpotrnpti vp hflpV cnnpp 

/TlIIII r\l UKjL jrVlllUaooaU-Ul t-O/LICoLI UtUVC L/aCJvoUaL'C 


act5s 


oiviniiy dvu 


adds 


alHio VlCWjJUlIll 


add<;9S 

aUUo^J 


addc rpcypnt 9^ \x/ith 1r*r*a1 rvrintino - 
aLlllo ICgClll jL+j WILLI iUCdl UllllLlllg, 


aHm 1 1 
dU.111 1 1 


1M alUlll 1 


aHm 1 9 
alilll x z, 


1 ci q ntn 1 / 
lol d-UllllZ. 


dlllilZ/ 


lei aHm9 
lol aU-lllZ, 


adm^ 
aUlIU 


lei adm^ 
lol auiiij 


adm^a 

aUliUa 


lei adm^a 
lol aU.lli.ja 


adm^a-l- 


lei adm^a-l- 
ioi au-iii^ai^ 




loi QnTYi^Q *x\ 10 9 hcind 
lol duiiijd ai ly.z, uduu 


adm ^a C*~* 


lei iiHm^ii \x/ith / 1 -fY^r- otandrvnt 
lol aUlllJ>a Willi \ ) 1U1 olallUAJUl 


adm S 

aU.lll_/ 


lei aHm^ 
loi aLiiiu 


aHm^ 1 

dLlllU 1 


j_<cai oicgici wld i 


aulll'+Z/ 


let aHmZL9 
loi aLiiii'+z^ 


ajo JU 


/AllUCloUll jaCUUoUll 


flltfK^ 


Altos TTT 


al tried. 

allUoT- 


AltnQ TV 

/TlIIUo 1 V 


alto^S 


Altos V 


amp219 


Ampex with Automargins 


am9 1 Qw 
cxin^ xy w 


Amnpy xx/ith 1 ^9 cnliimiic 
/T.111UCA Willi 1 JZ/ lAJlulllllo 




/T.111UCA 1V1UU.C1 Z*DZ, 


UillL/vA 


Amnpx dialoo'iip 


anCI 
dllol 


-A P#l>l IvV oLallU-cllU CI I 


cUXdi.llcU.ll 


AnQi QtfinHfirH prt without jnitnmarcrin 
/i-iioi o LaiiLiai sj. L/i l wiLiiuuL auL^iiiai^iii 


arnanpt 


nptwnrlr 


atari Qt 

ClLcXl lol 


Atari ST vtS9 

/A Lai 1 O 1 V LJ 


b26 


Burroughs <uisi monitor with 29 lines 


bh3m 


"Dpphivp TTTm 




ho line jL\ja,l 


clOO 


ConceDt 100 


c1004d 


c^ oo w/4 nflpps 


clOOrv 


r1 00 tpv viHpo 


c 1 OOrv/in 


p100 w/4 nacypQ 


p1 00rv4nna 

\s X \J\JX V I L'lJLcl 


p100 witH nr> firrnws 


C 1 UU1 V T"PPP 


tiw wiiii pimici pun 


r* 1 OOn/c 


S1UW icvcisc v_.uiiccpi 1UU 


clOOs 


slow Concept 100 


c3102 


Cromemco 3102 


carlock 


klc 
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cci 


cci 4574 


cdc456 


cdc 


cdc456tst 


dc456tst 


cdi 


cdi 1203 


cie467 


C.Itoh 467, 414 Graphics terminal 


cit80 


C.Itoh 80 


cit80nam 


C.Itoh 80 without automargins 


compucolor 


Compucolor II 


dl32 


Datagraphix 132a 


datapoint 


Datapoint 3360 


delta 


Delta data 5000 


dg 


Data general 6053 


digilog 


Digilog 333 


dm 1520 


Datamedia 1520 


dml521 


Datamedia 1521 


dm2500 


Datamedia 2500 


dm3025 


Datamedia 3025a 


dmterm 


Tandy Deskmate terminal 


dosansi 


ANSI.SYS standard crt 


dtlOO 


Tandy DT-100 terminal 


dtlOOw 


Tandy DT-100 terminal 


dt200 


Tandy DT-200 


dt80 


Datamedia dt80/l 


dt80132 


Datamedia dt80/l in 132 char mode 


dtc300s 


dtc 300s 


du 


dialup 


dumb 


unknown 


dwl 


Decwriter I 


dw2 


Decwriter II 


ep40 

r 


Execuport 4000 


ep48 


Execuport 4080 


espHAZ 


Esprit 6310 in Hazeltine emulation mode 


ethernet 


network 


exidy 


Exidy sorcerer as dm2500 


fos 


Fortune system 


fox 


Perkin elmer 1100 


free 100 


Freedom 100 


freellO 


Freedom 110 


ftl024 


Forward Technology graphics controller 


gt40 


Dec gt40 


gt42 


Dec gt42 


hl500 


Hazeltine 1500 


hl510 


Hazeltine 1510 


hl520 


Hazeltine 1520 


hl552 


Hazeltine 1552 


hl552rv 


Hazeltine 1552 reverse video 


h2000 


Hazeltine 2000 


hl9 


Heathkit hi 9 w/ function keypad 
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Illy a. 


ncauijs.li ii xy aiiM inuue 




Heathkit w/numeric keypad (not function keys) 


hp 


hp 264x series 


npzozo 


np zozo 


npzc+o 


jtlt zo'+od grapnics icirnindi 


hpansi 


riewiett racKara /uu/44 in rix-jr^Lerm moae 


hpex 


hp extended capabilites 


hpsub 


hp terminals ~ capability subset 


i 1 aa 
11UU 


General Terminal 100 A (formerly Infoton 100) 


IDIUjIUI 


TP.1V/f 1 1 A 1 1 A 


intext 


loL. mouiiieu owl izUU 


ipc 


mtei irL. 


KlU 


Kaypro 10 


kt7ix 


Kimtron kt-7 


lisa 


Apple Lisa XENIX terminal display (white on black) 


mlUU 


Kadio onacK model 1UU 


macterm 


Apple Macintosh terminal emulator in vtlOO mode 


macterm-nam 


MacTerm in vtlOO mode with automargin NOT set 


J1 1 1 A 

mall lu 


L-ybernex mal-1 1U 


microb 


Micro bee series 


microterm 


Microterm act iv 


microterm5 


Microterm act v 


mime 


Microterm mimel 


mime2a 


Microterm mime2a (emulating an enhanced vt52) 


mime2as 


Microterm mime2a (emulating an enhanced soroc iql20) 


mime3a 


mimel emulating 3a 


mime3ax 


mimel emulating enhanced 3a 


mimefb 


full bright mime 1 


mimehb 


half bright mimel 


mt/u 


Morrow mt70 


nabu 


Nabu terminal 


netx 


netronics 


nucterni 


NUC homebrew 


oadm3 1 


old adm3 1 


omron 


umron ouzdavj 


OtoU 


unyx otou 


owl 


X>oT-l>it-i a\mar 1 OA A 

irerKin eimer izuu 


pejju 


Perkin elmer 550 


pixel 


Pixel terminal 


piabllla 


pidsmd. panel 


r»ti ^aa 
pii JUU 


Convergent Technologies PT 


ptziu 


lanay iko-ou Jri-ziu printing terminal 


qume5 


Qume Sprint 5 


/-iirtl A1 

qvtiui 


yume vtiui 


nvtl01+ 

U YL1V1 1 


Oiimp vt101 Plus vprs c 


qvtlOl+so 


Qume vtl01+ with protected mode/standout 


qvtlOlb 


Qume vtlOl with cursor set to blinking underline 


qvtl02 


Qume vtl02 
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qvtiio 




qvtlUo 


Qume vtlOo 


qvtiuy 


Qume vtiuy 


qvti iy 


Qume vti iy 


n\rt'\ 1 Q_l_ 

qvti iy+ 


Qume vtl 19 Plus vers c 


qvtzui 


f^inr-y-ia *7+OA1 

Qume vtzui 


qvtZUz 


Qume vtzUz 


qvtZUi 


Qume vtz03 FLUb 


regent 


adds regent series 


regent20 


adds regent 20 


regent25 


adds regent 25 


regent25a 


adds regent 25a 


regent40 


adds regent 40 


regent60 


adds regent 60 


regent60na 


regent 60 w/no arrow keys 


regent 100 


adds regent 100 


-vim 


Rexon 303 terminal 


sbl 


Beehive superbee 


sbz 


£' 1 1 

lixed superbee 


sexidy 


Exidy smart 


SkoOzU 


beiko oOZU 


soroc 


boroc izu 


sun 


Sun Microsystems Workstation monitor 


superbeeic 


superbee with insert char 


switch 


intelligent switch 


swtp 


Southwest Technical Products ct82 


tlUOl 


leleray lOol 


1 1 A A 1 -P 


leleray lUol witn last rKUMs 


t3700 


dumb Teleray 3700 


t3800 


Teleray 3800 series 


tdzOO 


Tandy 200 


tek 


Tektronix 4012 


tek4013 


Tektronix 4013 


tek4014 


lektromx 4014 


tek4014sm 


Tektronix 4014 in small font 


tek4015 


Tektronix 4015 


tek4Ul jsm 


Tektronix 4015 in small font 


tek4023 


lektromx 4023 


teletec 


Teletec Datascreen 


terak 


Terak emulating Datamedia 1520 


ti 


Texas Instruments silent 700 


ti/45 


Texas Instruments silent 745 


ti924 


lexas Instruments 924 VD 1 / bit 


tiyz4-o 


lexas Instruments 924 VD 1 bit 


H926 


Texas Instruments 926 VDT 


ti931 


Texas Instruments 931 VDT 


trslOO 


Tandy TRS-80 Model 100 


trsl6 


Tandy trs-80 model 16 console 
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trs600 


Tandy Model 600 


tvi910 


old Televideo 910 


tvi910+ 


Televideo 910 PLUS 


tvi912 


old Televideo 


tvi924 


Televideo924 


tvi950 


Televideo950 


tvi950-2p 


Televideo950 w/2 pages 


tvi950-4p 


Televideo950 w/4 pages 


tvi950-ap 


Televideo950 w/alt pages 


tvi950b 


bare Televideo950 no is 


tvi950ns 


Televideo950 w/no standout 


tvi9220 


Televideo 9220 w/status line @ bottom 


tvi9220w 


Televideo 9220 132 col w/status line @ bottom 


v50 


Visual 50 emulation of DEC vt52 


v55 


Visual 55 emulation of DEC vt52 (called V55) 


vi50 


Visual 50 in ADDS viewpoint emulation 


vi55 


Visual 55 using ADDS emulation 


vi200 


Visual 200 with function keys 


vi200f 


Visual 200 no function keys 


vi200ic 


Visual 200 using insert char 


vi200rvic 


Visual 200 reverse video using insert char 


vi200rv 


Visual 200 reverse video 


vis613 


Visual 613 


vt50 


DEC vt50 


vt50h 


DEC vt50h 


vt52 


DEC vt52 


vt52so 


DEC vt52 with brackets added for standout use 


vtlOO 


DEC vtlOO 


vtlOO-nam 


DEC vtlOO without automargins 


vtlOOn 


DEC vtlOO w/no init 


vtlOOs 


DEC vtlOO 132 cols 14 lines 


vtlOOw 


DEC vtlOO 132 cols 


vtl02 


DEC vtl02 


vtl31 


DEC vtl31 


vtl32 


DEC vtl32 


vt220 


DEC vt220 generic 


vtz 


Zilog vtz 2/10 


w2110A 


Wang 2110 Asynch Data Entry Terminal - 80 column 


ws584 


Olivetti WS584 


ws584fr 


Olivetti WS584 with French keyboard 


ws584gr 


Olivetti WS584 with German keyboard 


ws584nr 


Olivetti WS584 with Norwegian/Danish keyboard 


ws584sp 


Olivetti WS584 with Spanish keyboard 


ws584sw 


Olivetti WS584 with Swedish/Finnish keyboard 


ws584uk 


Olivetti WS584 with U.K. keyboard 


ws584us 


Olivetti WS5o4with U.S.A. keyboard 


ws685 


Olivetti WS685 


wy30 


Wyse 30 
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wy50 Wyse 50 

wy50n Wyse 50 - 80 column screen, no automargin 

wy50vb Wyse 50 with visible bell 

wy50w Wyse 50 with 132 columns 

wy60 Wyse 60 with 80 column/24 line screen in wy60 mode 

wy60w Wyse 60 with 132 column/24 line screen in wy60 mode 

wy75 Wyse 75 with 80 column line 

wy75ap Wyse 75 with Applications and Cursor keypad modes 

wy75w Wyse 75 in 132 column mode 

wy75x Wyse 75 with 132 column lines in vi editor mode 

wy85 Wyse 85 in 80 column mode, vtlOO emulation 

wy85w Wyse 85 in 132 column mode, vtlOO emulation 

wylOO Wyse 100 

wy350 Wyse 350 80 column color terminal emulating wy50 

wy350w Wyse 350 132 column color terminal emulating wy50 

wy501 Wyse 60 with 80 column/43 line screen in WY50+ mode 

xl720 Xerox 1720 

xitex Xitexsct-100 

z29 Zenith z29 

zen30 zentec 30 

zen40 zentec 40 

zen50 zentec 50 

zephyr zentec zephyr220 in vtlOO mode 

zephyrnam zentec zephyr220 in vtlOO mode w/out automargins 

Files 

/etc/termcap 

See Also 

tset(C), environ(M), termcap(M) 
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Name 

terminfo - Terminal capability data base 



Syntax 

/usr/lib/terminfo/*/* 



Description 

terminfo is a data base describing terminals, used, e.g., by terminfo(S). 
Terminals are described in terminfo by a set of capabilities that they 
have, and by describing how operations are performed. Padding 
requirements and initialization sequences are included in terminfo. 

Entries in terminfo consist of a number of fields separated by commas 
White space after each ',' is ignored. The first entry for each ter- 
minal gives the various names that are known for the terminal. Each of 
these entries is separated by 'I '. The first name given is the most com- 
mon abbreviation for the terminal, (referred to as the "root name") 
the last name given should be a long name fully identifying the termi- 
nal, and all others are understood as synonyms for the terminal name. 
All names but the last should be in lower case and contain no blanks; 
the last name can contain upper case and blanks for readability. 

Terminal names (except for the last entry) should be chosen using the 
following conventions. The particular piece of hardware making up 
the terminal should have a root name chosen, for example, "hp2621". 
This name should not contain hyphens, except that synonyms may be 
chosen that do not conflict with other names. Modes that the 
hardware can be in, or user preferences, should be indicated by 
appending a hyphen and an indicator of the mode. Thus, a vt-100 in 
132 column mode would be vtlOO-w. The following suffixes should 
be used where possible: 



Suffix 


Meaning 


Example 


-w 


Wide mode (more than 80 columns) 


vtlOO-w 


-am 


With auto margins (usually default) 


vtlOO-am 


-nam 


Without automatic margins 


vtlOO-nam 


-n 


Number of lines on the screen 


aaa-60 


-na 


No arrow keys (leave them in local) 


clOO-na 


-np 


Number of pages of memory 


cl00-4p 


-rv 


Reverse video 


clOO-rv 



In the following table, the "variable" is the name by which the pro- 
grammer (using the terminfo library) accesses the capability. The 
"capname" is the short name used in the text of the database, and is 
used by a person updating the database. The "i.code" is the two letter 
internal code used in the compiled database, and always corresponds 
to the termcap(M) capability name. 
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Capability names have no hard length limit, but an informal limit of 5 
characters has been adopted to keep them short. Whenever possible, 
names are chosen to be the same as or similar to the ANSI X3.64-1979 
standard. Semantics are also intended to match those of the specifica- 
tion. 

(P) 

indicates that padding may be specified 

(G) 

indicates that the string is passed through tparm with parms as 
given (#/). 

(*) 

indicates that padding may be based on the number of lines 
affected 



indicates the / parameter, 
(f ) Not present in all versions of termcap. 



Variable 


Cap- 


I. 


Description 


Booleans: 


name 


Code 




auto_left_margin, 


bw 


bw 


cubl wraps from column to last 








column 


auto_right_margin, 


am 


am 


Terminal has automatic margins 


beehive_glitch, 


xsb 


xb 


Beehive (fl=escape, f2=ctrl C) 


ceol_standout_glitch, 


xhp 


xs 


Standout not erased by overwriting 








(hp) 


eat_newline_glitch, 


xenl 


xn 


Newline ignored after 80 cols 








(Concept) 


erase_overstrike, 


eo 


eo 


Can erase overstrikes with a blank 


generic_type, 


gn 


gn 


Generic line type (e.g., dialup, 








switch). 


hard_copy, 


he 


he 


Hardcopy terminal 


has_meta_key, 


km 


km 


Has a meta key (shift, sets parity 








bit) 


has_status_line, 


hs 


hs 


Has extra "status line" 


insert_null_glitch, 


in 


in 


Insert mode distinguishes nulls 


memory_above, 


da 


da 


Display may be retained above 








the screen 


memory _below, 


db 


db 


Display may be retained below 








the screen 


move_insert_mode, 


mir 


mi 


Safe to move while in insert mode 


move_standout_mode , 


msgr 


ms 


Safe to move in standout modes 


over_strike, 


OS 


OS 


Terminal overstrikes 


status_line_esc_ok, 


eslok 


es 


Escape can be used on the status 



line 
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teleray_glitch, 


xt 


xt 


Tabs ruin, magic so char 








(Teleray 1061) 


tilde_glitch, 


hz 


hz 


Hazeltine; can not print ~'s 


transparent_underline, 


ul 


ul 


Underline character overstrikes 


xon_xoff, 


xon 


xo 


Terminal uses XON/XOFF 








handshaking 


ISJinnhprc* 








columns, 


cols 


CO 


Number of columns in a line 


init tabs 


it 


it 


Tfib^ initifillv pvprv $ qtwppq 


lines, 


lines 


li 


Number of lines on screen or page 


lines_of_memory, 


lm 


lm 


Lines of memory if > lines. 








means varies 


magic_cookie_glitch, 


xmc 


S2 


Number of blank chars left by 








smso or rmso 


padding_baud_rate, 


pb 


pb 


Lowest baud where cr/nl padding 








is needed 


virtual_terminal, 


vt 


vt 


Virtual terminal number (UNIX 








system) 


W1U111 oldlUo 1111C, 


wsl 




N"r* rnlnmnc in c t q 1 1 1 c linp 
iiu. isUiuimio ill alalUo mic 


Strings: 








back tab, 


cbt 


bt 


Back tab (P) 


bell, 


bel 


bl 


Audible signal (bell) (P) 


carriage return, 


cr 


cr 


Carriage return (P*) 


change scroll region, 


csr 


CS 


Change to lines #1 through #2 








(vt-100) (PG) 


clear all tabs 


tbc 


Ct 


Clear all tab <;tnm (T*) 


ClCal alslCGU, 




ci 


V_-lCal oUXCCll OXi\X 11U1I1C L-UioUl \i ) 


clr eol 


el 


ce 


Clear to enH nf* line (J^\ 

\sLk/CLx WJ Ul Hilt- J 


clr_eos, 


ed 


cd 


Clear to end of display (P*) 


column address, 


hpa 


ch 


Set cursor column (PG) 


command_character, 


cmdch 


CC 


Term, settable cmd char in 








prototype 


cursor_address , 


CUD 


cm 


Screen rel. cursor motion row #1 








col #2 (PG) 


niT^ftr Hnwn 


cudl 


do 


JL/U W 11 VSIH^ 1111G 


cursor home 


home 


ho 


Home cursor (if no cup) 


pnr<jnr invisible 

^Ui JUI 111 V IijlUlC', 






1VXOA.G WUloVJl lllvloll/lC/ 


cursor left 


cubl 


le 


Move cursor left one space 


cursor_mem_address, 


mrcup 


CMt 


Memory relative cursor addressing 


cursor_normal, 


cnorm 


ve 


Make cursor appear normal 








(undo vs/vi) 


cursor_right, 


cufl 


nd 


Non-destructive space (cursor 








right) 


cursor_to_ll, 


11 


11 


Last line, first column (if no cup) 


cursor_up, 


cuul 


up 


Upline (cursor up) 
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cursor_visible, 


cvvis 


vs 


Make cursor very visible 


delete_character, 


dchl 


dc 


Delete character (P*) 


delete_line, 


dll 


dl 


Delete line (P*) 


dis_status_line, 


dsl 


ds 


Disable status line 


down_half_line, 


hd 


hd 


Half-line down (forward 1/2 








linefeed) 


enter_alt_charset_mode, 


smacs 


as 


Start alternate character set (P) 


enter_blink_mode, 


blink 


mb 


Turn on blinking 


enter_bold_mode, 


bold 


md 


Turn on bold (extra bright) mode 


enter_ca_mode, 


smcup 


ti 


String to begin programs that use 








cup 


enter_delete_mode, 


smdc 


dm 


Delete mode (enter) 


enter_dim_mode, 


dim 


mh 


Turn on half -bright mode 


enter_insert_mode, 


smir 


im 


Insert mode (enter); 


enter_protected_mode, 


prot 


mp 


Turn on protected mode 


enter_reverse_mode, 


rev 


mr 


Turn on reverse video mode 


enter_secure_mode, 


invis 


mk 


Turn on blank mode (chars 








invisible) 


enter_standout_mode, 


smso 


so 


Begin stand out mode 


enter_underline_mode, 


smul 


us 


Start underscore mode 


erase_chars 


ech 


ec 


Erase #1 characters (PG) 


exit_alt_charset_mode, 


rmacs 


ae 


End alternate character set (P) 


exit_attribute_mode, 


sgrO 


me 


Turn off all attributes 


exit_ca_mode, 


rmcup 


te 


String to end programs that use 








cup 


exit_delete_mode, 


rmdc 


ed 


End delete mode 


exit_insert_mode , 


rmir 


ei 


End insert mode 


exit_standout_mode, 


rmso 


se 


End stand out mode 


exit_underline_mode, 


rmul 


ue 


End underscore mode 


flash_screen, 


flash 


vb 


Visible bell (may not move cursor) 


form_feed, 


a 


ff 


Hardcopy terminal page eject (P*) 


from_status_line, 


fsl 


fs 


Return from status line 


init_l string, 


isl 


il 


Terminal initialization string 


init_2string, 


is2 


i2 


Terminal initialization string 


init_3string, 


is3 


i3 


Terminal initialization string 


init_file, 


if 


if 


Name of file containing is 


insert_character, 


ichl 


ic 


Insert character (P) 


insert_line, 


ill 


al 


Add new blank line (P*) 


insert_padding, 


ip 


ip 


Insert pad after character inserted 








(P*) 


key_backspace, 


kbs 


kb 


Sent by backspace key 


key_catab, 


ktbc 


ka 


Sent by clear-all-tabs key 


key_clear, 


kclr 


kCt 


Sent by clear screen or erase key 


key_ctab, 


kctab 


kt 


Sent by clear-tab key 


key_dc, 


kdchl 


kDf 


Sent by delete character key 


key_dl, 


kdll 


kLf 


Sent by delete line key 


key_down, 


kcudl 


kd 


Sent by terminal down arrow key 


key_eic, 


krmir 


kMt 


Sent by rmir or smir in insert 



mode 
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key_eol, 


kel 


kEf 


key_eos, 


ked 


kSt 


key_fO, 


kfO 


kO 


key_fl, 


kfl 


kl 


key_flO, 


kflO 


k 


key_f2, 


kf2 


k2 


key_f3, 


kfi 


k3 


key_f4, 


kf4 


k4 


key_f5, 


kf5 


k5 


key_f6, 


kf6 


k6 


key_f7, 


kf7 


k7 


V<=>v fR 
Jvcy io, 




KO 


key_f9, 


kf9 


k9 


key_home, 


khome 


kh 


key_ic, 


kichl 


kl 


key_il, 


kill 


kAt 


key_left, 


kcubl 


kl 


keyjl, 


kll 


kHt 


key_npage, 


knp 


kNf 


key_ppage, 


kpp 


kPt 


key_right, 


kcufl 


kr 


key_sf, 


kind 


kF| 


key_sr, 


kri 


kRt 


s\.\^ y o La. u , 


khts 


kTt 


key_up, 


kcuul 


ku 


keypad_local, 


rmkx 


ke 


keypad_xmit, 


smkx 


ks 


lab_fO, 


lfO 


10 


lab_fl, 


lfl 


11 


lab_flO, 


lflO 


la 


lab_f2, 


lf2 


12 


lab_fi, 


lf3 


13 


lab_f4, 


lf4 


14 


lab_f5, 


lf5 


15 


lab_f6, 


lf6 


16 


lab_f7, 


lf7 


17 


lab_f8, 


lf8 


18 


lab_f9, 


lf9 


19 


meta_on, 


SIM 


mm 


meta_off, 


rmm 


mo 


newline, 


nel 


nw 



pad_char, pad pc 

parm_dch, dch DCt 



Sent by clear-to-end-of-line key 
Sent by clear-to-end-of-screen 
key 

Sent by function key fO 
Sent by function key f 1 
Sent by function key f 10 
Sent by function key f2 
Sent by function key f3 
Sent by function key f4 
Sent by function key f5 
Sent by function key f6 
Sent by function key f7 
Sent by function key f8 
Sent by function key f9 
Sent by home key 
Sent by ins char/enter ins mode 
key 

Sent by insert line 

Sent by terminal left arrow key 

Sent by home-down key 

Sent by next-page key 

Sent by previous-page key 

Sent by terminal right arrow key 

Sent by scroll-forward/down key 

Sent by scroll-backward/up key 

Sent by set-tab key 

Sent by terminal up arrow key 

Out of "keypad transmit" mode 

Put terminal in "keypad transmit" 

mode 



Labels 


on 


function 


key 


fOif notfO 


Labels 


on 


function 


key 


fl if not fl 


Labels 


on 


function 


key 


flOifnot 


no 










Labels 


on 


function 


key 


f2ifnotf2 


Labels 


on 


function 


key 


f3ifnotf3 


Labels 


on 


function 


key 


f4ifnotf4 


Labels 


on 


function 


key 


f5 if not f5 


Labels 


on 


function 


key 


f6ifnotf6 


Labels 


on 


function 


key 


f7ifnotf7 


Labels 


on 


function 


key 


f8ifnotf8 


Labels 


on 


function 


key 


f9ifnotf9 



Turn on "meta mode" (8th bit) 
Turn off "meta mode" 
Newline (behaves like cr followed 
by If) 

Pad character (rather than null) 
Delete #1 chars (PG*) 
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parm delete line, 


dl 


DLt 


parm down cursor, 


cud 


DOf 


parm ich, 


ich 


ICf 


parm_index, 


indn 


SFt 


parm_insert_line, 


il 


ALf 


parm_left_cursor, 


cub 


LEf 


parm_right_cursor, 


cuf 


Rlf 


parm_rindex, 


rin 


SRt 


parm_up_cursor, 


cuu 


UPt 


pkey_key, 


pfkey 


pk 


pkey_local, 


pfloc 


P 1 


pkey_xmit, 


pfx 


px 


print_screen, 


mcO 


PS 


prtr_off, 


mc4 


Pf 


prtr_on, 


mc5 


po 


repeat_char, 


rep 


rp 


reset_l string, 


rsl 


rl 


reset_2string, 


rs2 


r2 


reset_3string, 


rs3 


r3 


reset_file, 


if 


rf 


restore_cursor, 


rc 


rc 


row_address, 


vpa 


cv 


save cursor 


sc 


sc 


scroll_forward, 


ind 


sf 


scroll_reverse, 


ri 


sr 


set_attributes, 


sgr 


sa 


set_tab, 


hts 


st 


set_window, 


wind 


wi 


tab, 


ht 


ta 


to_status_line, 


tsl 


ts 


underline_char, 


uc 


uc 


up_half_line, 


hu 


hu 


init_prog, 


iprog 


iP 


key_al, 


kal 


Kit 


key_a3, 


ka3 


K3f 



Delete #1 lines (PG*) 
Move cursor down #1 lines (PG*) 
Insert #1 blank chars (PG*) 
Scroll forward #1 lines (PG) 
Add #1 new blank lines (PG*) 
Move cursor left #1 spaces (PG) 
Move cursor right #1 spaces 
(PG*) 

Scroll backward #1 lines (PG) 
Move cursor up #1 lines (PG*) 
Prog funct key #1 to type 
string #2 

Prog funct key #1 to execute 
string #2 

Prog funct key #1 to xmit 
string #2 

Print contents of the screen 

Turn off the printer 

Turn on the printer 

Repeat char #1 #2 times. (PG*) 

Reset terminal completely to sane 

modes 

Reset terminal completely to sane 
modes 

Reset terminal completely to sane 
modes 

Name of file containing reset string 

Restore cursor to position of last sc 

Vertical position absolute 

(set row) (PG) 

Save cursor position (P) 

Scroll text up (P) 

Scroll text down (P) 

Define the video attributes (PG9) 

Set a tab in all rows, current 

column 

Current window is lines #l-#2 
cols #3-#4 

Tab to next 8 space hardware tab 
stop 

Go to status line, column #1 
Underscore one char and move 
past it 

Half-line up (reverse 1/2 linefeed) 
Path name of program for init 
Upper left of keypad 
Upper right of keypad 
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key_b2, 
key_cl, 
key_c3, 
prtr_non, 



kb2 
kcl 
kc3 



mc5p 



K2t 
K4t 
K5t 
pOt 



Center of keypad 
Lower left of keypad 
Lower right of keypad 
Turn on the printer for #1 bytes 



A Sample Entry 

The following entry, which describes the Concept- 100, is among the 
more complex entries in the terminfo file. 

conceptlOO | cl00| concept | cl04 | cl00-4p | concept 100, 

am, bel="G, blank=\EH, blink=\EC, clear="L$<2*>, cnorm=\Ew, 
cols#80, cr="M$<9>, cubl=~H, cudl=~J, cufl=\E=, 
cup=\Ea%pl%' '%+%c%p2%' '%+%c, 

cuul=\E;, cwis=\EW, db, dchl=\E~A$<16*>, dim=\EE, dll=\E~B$<3*>, 
ed=\EX$<16*>, el=\E"U$<16>, eo, flash=\Ek$<20>\EK, ht=\t$<8>, 
ill=\E~R$<3*>, in, ind=~J, .ind=~J$<9>, ip=$<16*>, 
is2=\EU\Ef\E7\E5\E8\El\ENH\EK\E\200\Eo&\200\Eo\47\E, 
kbs=~h, kcubl=\E>, kcudl=\E<, kcufl=\E=, kcuul=\E;, 
kfl=\E5, kf2=\E6, kf3=\E7, khome=\E?, 

lines#24, mir, pb#9600, prot=\EI, rep=\Er%pl%c%p2%' '%+%c$<.2*>, 
rev=\ED, rmcup=\Ev $<6>\Ep\r\n, rmir=\E\200, rmkx=\Ex, 
rmso=\Ed\Ee, rmul=\Eg, rmul=\Eg, sgrO=\EN\200, 
smcup=\EU\Ev 8p\Ep\r, smir=\E"P, smkx=\EX, smso=\EE\ED, 
smul=\EG, tabs, ul, vt#8, xenl, 

Entries may continue onto multiple lines by placing white space at the 
beginning of each line except the first. Comments lines begin with 
"#". Capabilities in terminfo are of three types: Boolean capabilities 
which indicate that the terminal has some particular feature, numeric 
capabilities giving the size of the terminal or the size of particular 
delays, and string capabilities, which give a sequence that can be used 
to perform particular terminal operations. 

Types of Capabilities 

All capabilities have names. For instance, the fact that the Concept 
has automatic margins (i.e., an automatic return and linefeed when the 
end of a line is reached) is indicated by the capability am. Hence the 
description of the Concept includes am. Numeric capabilities are fol- 
lowed by the character '#' and then the value. Thus cols, which indi- 
cates the number of columns the terminal has, gives the value '80' for 
the Concept. 

Finally, string valued capabilities, such as el (clear to end of line 
sequence) are given by the two-character code, an '=', and then a 
string ending at the next following A delay in milliseconds may 
appear anywhere in such a capability, enclosed in $<..> brackets, as in 
el=\EK$<3>, and padding characters are supplied by tputs to provide 
this delay. The delay can be either a number, e.g., '20', or a number 
followed by an '*', i.e., '3*'. A '*' indicates that the padding required 
is proportional to the number of lines affected by the operation, and 
the amount given is the per-affected-unit padding required. (In the 
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case of insert character, the factor is still the number of lines affected. 
This is always one unless the terminal has xenl and the software uses 
it.) When a '*' is specified, it is sometimes useful to give a delay of 
the form '3.5' to specify a delay per unit to tenths of milliseconds. 
(Only one decimal place is allowed.) 

A number of escape sequences are provided in the string valued capa- 
bilities for easy encoding of characters there. Both \E and \e map to 
an ESCAPE character, maps to a control-x for any appropriate x, 
and the sequences \n\l\r\t\b\f\s give a newline, linefeed, return, 
tab, backspace, formfeed, and space. Other escapes include V for ~, \\ 
for \ \ for comma, \: for :, and \0 for null. (NO will produce Y200, 
which does not terminate a string but behaves as a null character on 
most terminals.) Finally, characters may be given as three octal digits 
after a \. 

Sometimes individual capabilities must be commented out. To do 
this, put a period before the capability name. For example, see the 
second ind in the example above. 

Preparing Descriptions 

The most effective way to prepare a terminal description is to imitate 
the description of a similar terminal in terminfo and to build up a 
description gradually, using partial descriptions with vi to check that 
they are correct. Be aware that a very unusual terminal may expose 
deficiencies in the ability of the terminfo file to describe it or bugs in 
vi. To test easily a new terminal description you can set the environ- 
ment variable TERMINFO to a pathname of a directory containing the 
compiled description you are working on and programs will look there 
rather than in /usr/lib/terminfo. To get the padding for insert line 
right (if the terminal manufacturer did not document it) a severe test is 
to edit a copy of /etc/passwd at 9600 baud, delete 16 or so lines from 
the middle of the screen, then hit the 'u' key several times quickly. If 
the terminal display is scrambled, more padding is usually needed. A 
similar test can be used for insert character. 

Basic Capabilities 

The cols numeric capability describes the number of columns on each 
line for the terminal. If the terminal is a CRT, then the number of lines 
on the screen is given by the lines capability. If the terminal wraps 
around to the beginning of the next line when it reaches the right mar- 
gin, then it should have the am capability. If the terminal can clear its 
screen, leaving the cursor in the home position, then this is given by 
the clear string capability. If the terminal overstrikes (rather than 
clearing a position when a character is struck over) then it should have 
the os capability. If the terminal is a printing terminal, with no soft 
copy unit, give it both he and os. (os applies to storage scope termi- 
nals, such as TEKTRONIX 4010 series, as well as hard copy and APL 
terminals.) If there is a code to move the cursor to the left edge of the 
current row, give this as cr. (Normally this will be carriage return, 
control M.) If there is a code to produce an audible signal (bell, beep, 
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etc) define this as bel. 

If there is a code to move the cursor one position to the left (such as 
backspace) that capability should be defined as cubl. Similarly, 
codes to move to the right, up, and down should be defined as cufl, 
cuul, and cudl. These local cursor motions should not alter the text 
they pass over, for example, you would not normally use 'cufl= ' 
because the space would erase the character moved over. 

A very important point here is that the local cursor motions encoded in 
terminfo are undefined at the left and top edges of a CRT terminal. 
Programs should never attempt to backspace around the left edge, 
unless bw is given, and never attempt to go up locally off the top. In 
order to scroll text up, a program will go to the bottom left corner of 
the screen and send the ind (index) string. 

To scroll text down, a program goes to the top left corner of the screen 
and sends the ri (reverse index) string. The strings ind and ri are 
undefined when not on their respective coiners of the screen. 

Parameterized versions of the scrolling sequences are indn and rin, 
which have the same semantics as ind and ri except that they take one 
parameter, and scroll that many lines. They are also undefined except 
at the appropriate edge of the screen. 

The am capability tells whether the cursor sticks at the right edge of 
the screen when text is output, but this does not necessarily apply to a 
cufl from the last column. The only local motion which is defined 
from the left edge is when bw is given, in which case a cubl from the 
left edge will move to the right edge of the previous row. If bw is not 
given, the effect is undefined. This is useful for drawing a box around 
the edge of the screen, for example. If the terminal has switch select- 
able automatic margins, the terminfo file usually assumes that this is 
on; i.e., am. If the terminal has a command which moves to the first 
column of the next line, that command can be given as nel (newline). 
It does not matter if the command clears the remainder of the current 
line, so if the terminal has no cr and If it may still be possible to craft 
a working nel out of one or both of them. 

These capabilities suffice to describe hardcopy and glass-tty terminals. 
Thus the model 33 teletype is described as: 

33 | tty33 | tty | model 33 teletype, 

bel=~G, cols#72, cr=~M, cudl="J, he, ind="J, os, 

while the Lear Siegler ADM-3 is described as: 

adm3 | 3 | lsi adm3, 

am, bel=~G, clear=~Z, cols#80, cr="M, cubl=~H, cudl="J, 
ind=~J,, lines#24, 
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Parameterized Strings 

Cursor addressing and other strings requiring parameters in the termi- 
nal are described by a parameterized string capability, with printf (S) 
like escapes %x in it. For example, to address the cursor, the cup 
capability is given, using two parameters: the row and column to 
address to. (Rows and columns are numbered from zero and refer to 
the physical screen visible to the user, not to any unseen memory.) If 
the terminal has memory relative cursor addressing, that can be indi- 
cated by mrcup. 

The parameter mechanism uses a stack and special % codes to mani- 
pulate it. Typically a sequence will push one of the parameters onto 
the stack and then print it in some format. Often more complex opera- 
tions are necessary. 

The % encodings have the following meanings: 



%% outputs '%' 

%d print pop() as in printf 

%2d print pop() like %2d 

%3d print pop() like %3d 

%02d 

%03d as in printf 

%c print pop() gives %c 

%s print pop() gives %s 



%p[l-9] pushithparm 

%P[a-z] set variable [a-z] to pop() 

%g[a-z] get variable [a-z] and push it 

%'c' char constant c 

% { nn } integer constant nn 



%+%-%* %/ %m 

arithmetic (%m is mod): push(pop() op pop()) 
%& %l % A bit operations: push(pop() op pop()) 
%= %> %< logical operations: push(pop() op pop()) 
%! %~ unary operations push(op pop()) 

%i add 1 to first two parms (for ANSI terminals) 

%? expr %t thenpart %e elsepart %; 

if-then-else, %e elsepart is optional, 
else-if's are possible ala Algol 68: 

%? Cj %t b 1 %e c 2 %t b 2 %e c 3 %t b 3 %e c 4 %t b 4 %e %; 

c. are conditions, b- are bodies. 

Binary operations are in postfix form with the operands in the usual 
order. That is, to get x-5 one would use "%gx%{5}%-". 

Consider the HP2645, which, to get to row 3 and column 12, needs to 
be sent \E&al2c03Y padded for 6 milliseconds. Note that the order of 
the rows and columns is inverted here, and that the row and column 
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are printed as two digits. Thus its cup capability is 
cup=\E&%p2%2dc%p 1 %2dY$<6>. 

The Microterm ACT-IV needs the current row and column sent pre- 
ceded by a A T, with the row and column simply encoded in binary, 
cup=T%pl%c%p2%c. Terminals that use %c need to be able to 
backspace the cursor (cubl), and to move the cursor up one line on the 
screen (cuul). This is necessary because it is not always safe to 
transmit \n "D and \r, as the system may change or discard them. (The 
library routines dealing with terminfo set tty modes so that tabs are 
never expanded, so \t is safe to send. This turns out to be essential for 
the Ann Arbor 4080.) 

A final example is the LSI ADM-3a, which uses row and column offset 
by a blank character, thus cup=\E=%pl%' '%+%c%p2%' '%+%c. 
After sending '\E=', this pushes the first parameter, pushes the ASCII 
value for a space (32), adds them (pushing the sum on the stack in 
place of the two previous values) and outputs that value as a character. 
Then the same is done for the second parameter. More complex arith- 
metic is possible using the stack. 

If the terminal has row or column absolute cursor addressing, these 
can be given as single parameter capabilities hpa (horizontal position 
absolute) and vpa (vertical position absolute). Sometimes these are 
shorter than the more general two parameter sequence (as with the 
HP2645) and can be used in preference to cup . If there are parameter- 
ized local motions (e.g., move n spaces to the right) these can be given 
as cud, cub, cuf, and cuu with a single parameter indicating how 
many spaces to move. These are primarily useful if the terminal does 
not have cup, such as the TEKTRONIX 4025. 

Cursor Motions 

If the terminal has a fast way to home the cursor (to very upper left 
corner of screen) then this can be given as home; similarly a fast way 
of getting to the lower left-hand corner can be given as 11; this may 
involve going up with cuul from the home position, but a program 
should never do this itself (unless 11 does) because it can make no 
assumption about the effect of moving up from the home position. 
Note that the home position is the same as addressing to (0,0): to the 
top left corner of the screen, not of memory. (Thus, the \EH sequence 
on HP terminals cannot be used for home.) 

Area Clears 

If the terminal can clear from the current position to the end of the 
line, leaving the cursor where it is, this should be given as el. If the 
terminal can clear from the current position to the end of the display, 
then this should be given as ed. ed is only defined from the first 
column of a line. (Thus, it can be simulated by a request to delete a 
large number of lines, if a true ed is not available.) 
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Insert/delete line 

If the terminal can open a new blank line before the line where the 
cursor is positioned, this should be given as ill; this is done only from 
the first position of a line. The cursor must then appear on the newly 
blank line. If the terminal can delete the line on which the cursor is 
positioned, then this should be given as dll; this is done only from the 
first position on the line to be deleted. Versions of ill and dll that 
take a single parameter and insert or delete that many lines can be 
given as il and dl. If the terminal has a settable scrolling region (like 
the vt-100) the command that sets this can be described with the csr 
capability, which takes two parameters: the top and bottom lines of 
the scrolling region. The cursor position is, however, undefined after 
using this command. It is possible to get the effect of insert or delete 
line using this command - the sc and rc (save and restore cursor) com- 
mands are also useful. Inserting lines at the top or bottom of the 
screen can also be done using ri or ind on many terminals without a 
true insert/delete line, and is often faster even on terminals with those 
features. 

If the terminal has the ability to define a window as part of memory, 
which all commands affect, it should be given as the parameterized 
string wind. The four parameters are the starting and ending lines in 
memory and the starting and ending columns in memory, in that order. 

If the terminal can retain display memory above, then the da capabil- 
ity should be given; if display memory can be retained below, then db 
should be given. These indicate that deleting a line or scrolling may 
bring non-blank lines up from below or that scrolling back with ri may 
bring down non-blank lines. 

Insert/Delete Character 

There are two basic kinds of intelligent terminals with respect to 
insert/delete character that can be described using terminfo. The most 
common insert/delete character operations affect only the characters 
on the current line and shift characters off the end of the line rigidly. 
Other terminals, such as the Concept 100 and the Perkin Elmer Owl, 
make a distinction between typed and untyped blanks on the screen, 
shifting upon an insert or delete only to an untyped blank on the 
screen which is either eliminated, or expanded to two untyped blanks. 
You can determine the kind of terminal you have by clearing the 
screen and then typing text separated by cursor motions. Type 
abc def using local cursor motions (not spaces) between the abc and 
the def. Then position the cursor before the abc and put the terminal 
in insert mode. If typing characters causes the rest of the line to shift 
rigidly and characters to fall off the end, then your terminal does not ( 
distinguish between blanks and untyped positions. If the "abc" shifts 
over to the def which then move together around the end of the current 
line and onto the next as you insert, you have the second type of termi- 
nal, and should give the capability in, which stands for insert null. 
While these are two logically separate attributes (one line vs. multi- 
line insert mode, and special treatment of untyped spaces) we have 
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seen no terminals whose insert mode cannot be described with the sin- 
gle attribute. 

terminfo can describe both terminals that have an insert mode, and ter- 
minals that send a simple sequence to open a blank position on the 
current line. To get into insert mode use the smir sequence. To leave 
insert mode use the rmir sequence. Now give as ichl any sequence 
needed to be sent just before sending the character to be inserted. 
Most terminals with a true insert mode will not give ichl; terminals 
that send a sequence to open a screen position should give it here. (If 
your terminal has both, insert mode is usually preferable to ichl. Do 
not give both unless the terminal actually requires both to be used in 
combination.) If post insert padding is needed, give this as a number 
of milliseconds in ip (a string option). Any other sequence which may 
need to be sent after an insert of a single character may also be given 
in ip. If your terminal needs both to be placed into an 'insert mode' 
and a special code to precede each inserted character, then both 
smir/rmir and ichl can be given, and both will be used. The ich 
capability, with one parameter, n, will repeat the effects of ichl n 
times. 

It is occasionally necessary to move around while in insert mode to 
delete characters on the same line (e.g., if there is a tab after the inser- 
tion position). If your terminal allows motion while in insert mode 
you can give the capability mir to speed up inserting in this case. 
Omitting mir will affect only speed. Some terminals (notably 
Datamedia's) must not have mir because of the way their insert mode 
works. 

Finally, you can specify dchl to delete a single character, dch with 
one parameter, n, to delete n characters, and delete mode by giving 
smdc and rmdc to enter and exit delete mode (any mode the terminal 
needs to be placed in for dchl to work). 

A command to erase n characters (equivalent to outputting n blanks 
without moving the cursor) can be given as ech with one parameter. 

Highlighting, Underlining, and Visible Bells 

If your terminal has one or more kinds of display attributes, these can 
be represented in a number of different ways. You should choose one 
display form as standout mode, representing a good, high contrast, 
easy-on-the-eyes, format for highlighting error messages and other 
attention getters. (If you have a choice, reverse video plus half-bright 
is good, or reverse video alone.) The sequences to enter and exit stan- 
dout mode are given as smso and rmso, respectively. If the code to 
change into or out of standout mode leaves one or even two blank 
spaces on the screen, as the TVI 912 and Teleray 1061 do, then xmc 
should be given to tell how many spaces are left. 

Codes to begin underlining and end underlining can be given as smul 
and rmul respectively. If the terminal has a code to underline the 
current character and move the cursor one space to the right, such as 
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the Microterm Mime, this can be given as uc. 

Other capabilities to enter various highlighting modes include blink 
(blinking) bold (bold or extra bright) dim (dim or half-bright) invis 
(blanking or invisible text) prot (protected) rev (reverse video) sgrO 
(turn off all attribute modes) smacs (enter alternate character set 
mode) and rmacs (exit alternate character set mode). Turning on any 
of these modes singly may or may not turn off other modes. 

If there is a sequence to set arbitrary combinations of modes, this 
should be given as sgr (set attributes), taking 9 parameters. Each 
parameter is either or 1, as the corresponding attribute is on or off. 
The 9 parameters are, in order: standout, underline, reverse, blink, 
dim, bold, blank, protect, alternate character set. Not all modes need 
be supported by sgr, only those for which corresponding separate attri- 
bute commands exist. 

Terminals with the "magic cookie" glitch (xmc) deposit special 
"cookies" when they receive mode-setting sequences, which affect 
the display algorithm rather than having extra bits for each character. 
Some terminals, such as the HP 2621, automatically leave standout 
mode when they move to a new line or the cursor is addressed. Pro- 
grams using standout mode should exit standout mode before moving 
the cursor or sending a newline, unless the msgr capability, asserting 
that it is safe to move in standout mode, is present. 

If the terminal has a way of flashing the screen to indicate an error 
quietly (a bell replacement) then this can be given as flash; it must not 
move the cursor. 

If the cursor needs to be made more visible than normal when it is not 
on the bottom line (to make, for example, a non-blinking underline 
into an easier to find block or blinking underline) give this sequence as 
cvvis. If there is a way to make the cursor completely invisible, give 
that as civis. The capability cnorm should be given which undoes the 
effects of both of these modes. 

If the terminal needs to be in a special mode when running a program 
that uses these capabilities, the codes to enter and exit this mode can 
be given as smcup and rmcup. 

This arises, for example, from terminals like the Concept with more 
than one page of memory. If the terminal has only memory relative 
cursor addressing and not screen relative cursor addressing, a one 
screen-sized window must be fixed into the terminal for cursor 
addressing to work properly. This is also used for the TEKTRONIX 
4025, where smcup sets the command character to be the one used by 
terminfo. 

If your terminal correctly generates underlined characters (with no 
special codes needed) even though it does not overstrike, men you 
should give the capability ill. If overstrikes are erasable with a blank, 
then this should be indicated by giving eo. 
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Keypad 

If the terminal has a keypad that transmits codes when the keys are 
pressed, this information can be given. Note that it is not possible to 
handle terminals where the keypad only works in local (this applies, 
for example, to the unshifted HP 2621 keys). If the keypad can be set 
to transmit or not transmit, give these codes as smkx and rmkx. Oth- 
erwise the keypad is assumed to always transmit. The codes sent by 
the left arrow, right arrow, up arrow, down arrow, and home keys can 
be given as kcubl, kcufl, kcuul, kcudl, and khome respectively. If 
there are function keys such as fO, fl, flO, the codes they send can 
be given as kfO, kfl, kflO. If these keys have labels other than the 
default fO through flO, the labels can be given as lfO, lfl, lflO. The 
codes transmitted by certain other special keys can be given: kll 
(home down), kbs (backspace), ktbc (clear all tabs), kctab (clear the 
tab stop in this column), kclr (clear screen or erase key), kdchl 
(delete character), kdll (delete line), krmir (exit insert mode), kel 
(clear to end of line), ked (clear to end of screen), kichl (insert char- 
acter or enter insert mode), kill (insert line), knp (next page), kpp 
(previous page), kind (scroll forward/down), kri (scroll backward/up), 
khts (set a tab stop in this column). In addition, if the keypad has a 3 
by 3 array of keys including the four arrow keys, the other five keys 
can be given as kal, ka3, kb2, kcl, and kc3. These keys are useful 
when the effects of a 3 by 3 directional pad are needed. 

Tabs and Initialization 

If the terminal has hardware tabs, the command to advance to the next 
tab stop can be given as ht (usually control I). A "backtab" command 
that moves leftward to the next tab stop can be given as cbt. By con- 
vention, if the teletype modes indicate that tabs are being expanded by 
the computer rather than being sent to the terminal, programs should 
not use ht or cbt even if they are present, since the user may not have 
the tab stops properly set. If the terminal has hardware tabs which are 
initially set every n spaces when the terminal is powered up, the 
numeric parameter it is given, showing the number of spaces the tabs 
are set to. This is normally used by the tset(C) command to determine 
whether to set the mode for hardware tab expansion, and whether to 
set the tab stops. If the terminal has tab stops that can be saved in 
nonvolatile memory, the terminfo description can assume that they are 
properly set. 

Other capabilities include isl, is2, and is3, initialization strings for the 
terminal, iprog, the path name of a program to be run to initialize the 
terminal, and if, the name of a file containing long initialization 
strings. These strings are expected to set the terminal into modes con- 
sistent with the rest jof the terminfo description. They are normally 
sent to the terminal, by the tset program, each time the user logs in. 
They will be printed in the following order: isl; is2; setting tabs using 
tbc and hts; if; running the program iprog; and finally is3. Most ini- 
tialization is done with is2. Special terminal modes can be set up 
without duplicating strings by putting the common sequences in is2 
and special cases in isl and is3. A pair of sequences that does a 
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harder reset from a totally unknown state can be analogously given as 
rsl, rs2, rf, and rs3, analogous to is2 and if. Commands are normally 
placed in rs2 and rf only if they produce annoying effects on the 
screen and are not necessary when logging in. For example, the com- 
mand to set the vt-100 into 80-column mode would normally be part 
of is2, but it causes an annoying glitch of the screen and is not nor- 
mally needed since the terminal is usually already in 80 column mode. 

If there are commands to set and clear tab stops, they can be given as 
tbc (clear all tab stops) and hts (set a tab stop in the current column of 
every row). If a more complex sequence is needed to set the tabs than 
can be described by this, the sequence can be placed in is2 or if. 

Delays 

Certain capabilities control padding in the teletype driver. These are 
primarily needed by hard copy terminals, and are used by the tset pro- 
gram to set teletype modes appropriately. Delays embedded in the 
capabilities cr, ind, cubl, ff, and tab will cause the appropriate delay 
bits to be set in the teletype driver. If pb (padding baud rate) is given, 
these values can be ignored at baud rates below the value of pb. 

Miscellaneous 

If the terminal requires other than a null (zero) character as a pad, then 
this can be given as pad. Only the first character of the pad string is 
used. 

If the terminal has an extra "status line" that is not normally used by 
software, this fact can be indicated. If the status line is viewed as an 
extra line below the bottom line, into which one can cursor address 
normally (such as the Heathkit hl9's 25th line, or the 24th line of a 
vt-100 which is set to a 23-line scrolling region), the capability hs 
should be given. Special strings to go to the beginning of the status 
line and to return from the status line can be given as tsl and fsl. (fsl 
must leave the cursor position in the same place it was before tsl. If 
necessary, the sc and re strings can be included in tsl and fsl to get 
this effect.) The parameter tsl takes one parameter, which is the 
column number of the status line the cursor is to be moved to. If 
escape sequences and other special commands, such as tab, work 
while in the status line, the flag eslok can be given. A string which 
turns off the status line (or otherwise erases its contents) should be 
given as dsl. If the terminal has commands to save and restore the 
position of the cursor, give them as sc and rc. The status line is nor- 
mally assumed to be the same width as the rest of the screen, e.g., 
cols. If the status line is a different width (possibly because the termi- 
nal does not allow an entire line to be loaded) the width, in columns, 
can be indicated with the numeric parameter wsl. 

If the terminal can move up or down half a line, this can be indicated 
with hu (half-line up) and hd (half-line down). This is primarily use- 
ful for superscripts and subscripts on hardcopy terminals. If a hard- 
copy terminal can eject to the next page (form feed), give this as ff 
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(usually control L). 

If there is a command to repeat a given character a given number of 
times (to save time transmitting a large number of identical charac- 
ters) this can be indicated with the parameterized string rep. The first 
parameter is the character to be repeated and the second is the number 
of times to repeat it. Thus, tparm(repeat_char, 'x\ 10) is the same as 
'xxxxxxxxxx'. 

If the terminal has a settable command character, such as the TEK- 
TRONIX 4025, this can be indicated with cmdch. A prototype com- 
mand character is chosen which is used in all capabilities. This char- 
acter is given in the cmdch capability to identify it. The following 
convention is supported on some XENIX systems: The environment is 
to be searched for a CC variable, and if found, all occurrences of the 
prototype character are replaced with the character in the environment 
variable. 

Terminal descriptions that do not represent a specific kind of known 
terminal, such as switch, dialup, patch, and network, should include 
the gn (generic) capability so that programs can complain that they do 
not know how to talk to the terminal. 

If the terminal uses XON/XOFF handshaking for flow control, give 
xon. Padding information should still be included so that routines can 
make better decisions about costs, but actual pad characters will not 
be transmitted. 

If the terminal has a "meta key" which acts as a shift key, setting the 
8th bit of any character transmitted, this fact can be indicated with 
km. Otherwise, software will assume that the 8th bit is parity and it 
will usually be cleared. If strings exist to turn this "meta mode" on 
and off, they can be given as smm and rmm. 

If the terminal has more lines of memory than will fit on the screen at 
once, the number of lines of memory can be indicated with Im. A 
value of lm#0 indicates that the number of lines is not fixed, but that 
there is still more memory than fits on the screen. 

If the terminal is one of those supported by the UNIX virtual terminal 
protocol, the terminal number can be given as vt. 

Media copy strings that control an auxiliary printer connected to the 
terminal can be given as mcO: print the contents of the screen, mc4: 
turn off the printer, and mc5: turn on the printer. When the printer is 
on, all text sent to the terminal will be sent to the printer. It is 
undefined whether the text is also displayed on the terminal screen 
when the printer is on. A variation mc5p takes one parameter, and 
leaves the printer on for as many characters as the value of the param- 
eter, then turns the printer off. The parameter should not exceed 255. 
All text, including mc4, is transparently passed to the printer while an 
mc5p is in effect. 
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Strings to program function keys can be given as pfkey, pfloc, and 
pfx. Each of these strings takes two parameters: the function key 
number to program (from to 10) and the string to program it with. 
Function key numbers out of this range may program undefined keys 
in a terminal dependent manner. The difference between the capabili- 
ties is that pfkey causes pressing the given key to be the same as the 
user typing the given string; pfloc causes the string to be executed by 
the terminal in local; and pfx causes the string to be transmitted to the 
computer. 

Glitches and Unusual Capabilities 

Hazeltine terminals, which do not allow characters to be displayed 
should indicate hz. 

Terminals that ignore a linefeed immediately after an am wrap, such 
as the Concept and vt-100, should indicate xenl. 

If el is required to get rid of standout (instead of merely writing nor- 
mal text on top of it), xhp should be given. 

Teleray terminals, where tabs turn all characters moved over to 
blanks, should indicate xt (destructive tabs). This glitch is also taken 
to mean that it is not possible to position the cursor on top of a ' 'magic 
cookie", that to erase standout mode it is instead necessary to use 
delete and insert line. 

The Beehive Superbee, which is unable to correctly transmit the 
escape or control C characters, has xsb, indicating that the fl key is 
used for escape and f2 for control C. (Only certain Superbees have 
this problem, depending on the ROM.) 

Other specific terminal problems may be corrected by adding more 
capabilities of the form xx. 

Similar Terminals 

If there are two very similar terminals, one can be defined as being 
just like the other with certain exceptions. The string capability use 
can be given with the name of the similar terminal. The capabilities 
given before use override those in the terminal type invoked by use. 
A capability can be cancelled by placing xx@ to the left of the capa- 
bility definition, where xx is the capability. For example, the entry 

262 1 -nl, smkx@ , rmkx@ , use=262 1 , 

defines a 2621-nl that does not have the smkx or rmkx capabilities, 
and hence does not turn on the function key labels when in visual 
mode. This is useful for different modes for a terminal, or for different 
user preferences. 
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Files 

/usr/lib/terminfo/? /* 

files containing terminal descriptions compiled by tic(C) 

See Also 

terminfo(S), terminfo(F), tic(C) 

Notes 

Neither vi, tset, nor any other XENIX command presently uses ter- 
minfo. It is intended that a full integration of termcap and terminfo 
will be provided in a future version of XENIX. 



May 16, 1988 



Page 19 



( 



TERMIO (M) 



TERMIO (M) 



Name 

termio - General terminal interface. 



Description 

All asynchronous communications ports use the same general inter- 
face, no matter what hardware is involved. The remainder of this sec- 
tion discusses the common features of this interface. 

When a terminal file is opened, it normally causes the process to wait 
until a connection is established. In practice, users' programs seldom 
open these files; they are opened by getty(M) and become a user's 
standard input, output, and error files. The very first terminal file 
opened by the process group leader of a terminal file not already asso- 
ciated with a process group becomes the "control terminal" for that 
process group. The control terminal plays a special role in handling 
quit and interrupt signals, as discussed below. The control terminal is 
inherited by a child process during a fork(S). A process can break this 
association by changing its process group using setpgrp(S). 

A terminal associated with one of these files ordinarily operates in 
full-duplex mode. Characters can be entered at any time, even while 
output is occurring, and are only lost when the system's character 
input buffers become completely full, which is rare, or when the user 
has accumulated the maximum allowed number of input characters 
that have not yet been read by some program. Currently, this limit is 
256 characters. When the input limit is reached, all the saved charac- 
ters are thrown away without notice. 

Normally, terminal input is processed in units of lines. A line is del- 
imited by a newline (ASCII LF) character, an end-of-file (ASCII EOT) 
character, or an end-of-line character. This means that a program 
attempting to read will be suspended until an entire line has been 
entered. Also, no matter how many characters are requested in the 
read call, one line will be returned at most. It is not, however, neces- 
sary to read a whole line at once; any number of characters may be 
requested in a read, even one, without losing information. 

Erase and kill processing is normally done during input. By default, a 
Ctrl-H or BACKSPACE erases the last character typed, except that it 
will not erase beyond the beginning of the line. By default, a Ctrl-U 
kills (deletes) the entire input line, and optionally outputs a newline 
character. Both these characters operate on a key-stroke basis, 
independent of any backspacing or tabbing that may have been done. 
Both the erase and kill characters may be entered literally by preced- 
ing them with the escape character (\). In this case, the escape charac- 
ter is not read. The erase and kill characters may be changed (see 
stty(C)). 
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Certain characters have special functions on input. These functions 
and their default character values are summarized as follows: 

INTR (Rubout or ASCII DEL) Generates an interrupt signal which 
is sent to all processes with the associated control terminal. 
Normally, each such process is forced to terminate, but 
arrangements may be made either to ignore the signal or to 
receive a trap to an agreed-upon location; see signal (S). 

QUIT (CtrlA or ASCII FS) Generates a quit signal. Its treatment is 
identical to the interrupt signal except that, unless a receiv- 
ing process has made other arrangements, it will not only be 
terminated, but a core image file (called core) will be 
created in the current working directory. 

SWTCH (ASCII NUL) Is used by the job control facility, shl(C), to 
change the current layer to the control layer. 

ERASE (Ctrl-H) Erases the preceding character. It will not erase 
beyond the start of a line, as delimited by a NL, EOF, or EOL 
character. 

KILL (Ctrl-U) Deletes the entire line, as delimited by a NL, EOF, or 
EOL character. 

EOF (Ctrl-D or ASCII EOT) May be used to generate an end-of-file 
from a terminal. When received, all the characters waiting 
to be read are immediately passed to the program, without 
waiting for a newline, and the EOF is discarded. Thus, if 
there are no characters waiting, which is to say the EOF 
occurred at the beginning of a line, zero characters will be 
passed back, which is the standard end-of-file indication. 

NL (ASCII LF) Is the normal line delimiter. It cannot be changed 
or escaped. 

EOL (ASCII NUL) Is an additional line delimiter, like NL. It is not 
normally used. 

STOP (Ctrl-S or ASCII DC3) Temporarily suspends output. It is use- 
ful with CRT terminals to prevent output from disappearing 
before it can be read. While output is suspended, STOP char- 
acters are ignored and not read. 

START (Ctrl-Q or ASCII DC1) Resumes output which has been 
suspended by a STOP character. While output is not 
suspended, START characters are ignored and not read. The 
START/STOP characters cannot be changed or escaped. 

The character values for INTR, QUIT, SWTCH, ERASE, KILL, EOF, and 
EOL may be changed to suit individual tastes. The ERASE, KILL, and 
EOF characters may be escaped by a preceding backslash (\) character, 
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in which case no special function is carried out. 

When the carrier signal from the dataset drops, a ' 'hangup' ' signal is 
sent to all processes that have this terminal as the control terminal. 
Unless other arrangements have been made, this signal causes the 
processes to terminate. If the hangup signal is ignored, any subse- 
quent read returns with an end-of-file indication. Thus, programs that 
read a terminal and test for an end-of-file can terminate appropriately 
when hung up on. 

When one or more characters are written, they are transmitted to the 
terminal as soon as the previously typed characters have been entered. 
Input characters are echoed by putting them in the output queue as 
they arrive. If a process produces characters more rapidly than they 
can be typed, it will be suspended when its output queue exceeds a 
given limit. When the queue has drained down to the given threshold, 
the program is resumed. 

Several ioctl (S) system calls apply to terminal files. The primary calls 
use the following structure, defined in the file <termio.h>: 



#define NCC 8 

struct termio { 

unsigned short 
unsigned short 
unsigned short 
unsigned short 
char 

unsigned char 

}; 



c_iflag; /* input modes */ 
c_oflag; /* output modes */ 
c_cflag; /* control modes */ 
cjflag; /* local modes */ 
c_line; /* line discipline */ 
c_cc[NCC];/* control chars */ 



The special control characters are defined by the array c_cc . The rela- 
tive positions and initial values for each function are as follows: 






VINTR 


DEL 


1 


VQUIT 


FS 


2 


VERASE 


Ctrl-H 


3 


VKILL 


Ctrl-U 


4 


VEOF/VMIN 


EOT 


5 


VEOL/VTIME 


NUL 


6 


Reserved 




7 


VSWTCH 


NUL 



The cjflag field describes the basic terminal input control: 

IGNBRK 0000001 Ignores break condition 

BRKINT 0000002 Signals interrupt on break 

IGNPAR 0000004 Ignores characters with parity errors 

PARMRK 0000010 Marks parity errors 

INPCK 0000020 Enables input parity check 

ISTRIP 0000040 Strips character 

INLCR 0000 1 00 Maps NL to CR on input 
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IGNCR 0000200 Ignores CR 

ICRNL 0000400 Maps CR to NL on input 

IUCLC 0001000 Maps uppercase to lowercase on input 

IXON 0002000 Enables start/stop output control 

IX ANY 0004000 Enables any character to restart output 

IXOFF 0010000 Enables start/stop input control 

CTSFLOW 0020000 Enables CTS protocol for a modem line 

RTSFLOW 0040000 Enables RTS signaling for a modem line 

If IGNBRK is set, the break condition (a character framing error with 
data all zeros) is ignored, that is, not put on the input queue and there- 
fore not read by any process. Otherwise, if BRKINT is set the break 
condition will generate an interrupt signal and flush both the input and 
output queues. If IGNPAR is set, characters with other framing and 
parity errors are ignored. 

If PARMRK is set, a character with a framing or parity error which is 
not ignored is read as the 3-character sequence: 0377, 0, X, where X 
is the data of the character received in error. To avoid ambiguity in 
this case, if ISTRIP is not set, a valid character of 0377 is read as 0377, 
0377. If PARMRK is not set, a framing or parity error which is not 
ignored is read as the character NUL (0). 

If INPCK is set, input parity checking is enabled. If INPCK is not set, 
input parity checking is disabled. This allows output parity generation 
without input parity errors. 

If ISTRIP is set, valid input characters are first stripped to 7-bits, other- 
wise all 8-bits are processed. 

If INLCR is set, a received NL character is translated into a CR charac- 
ter. If IGNCR is set, a received CR character is ignored (not read). 
Otherwise, if ICRNL is set, a received CR character is translated into a 
NL character. 



If IUCLC is set, a received uppercase alphabetic character is translated 
into the corresponding lowercase character. 

If IXON is set, start/stop output control is enabled. A received STOP 
character will suspend output and a received START character will 
restart output. All start/stop characters are ignored and not read. If 
IXANY is set, any input character will restart output which has been 
suspended. 

If IXOFF is set, the system will transmit START characters when the 
input queue is nearly empty and STOP characters when nearly full. 

If CTSFLOW or RTSFLOW are set, IXON and IXANY should also be 
set so that these two types of flow control do not interfere with each 
other. 
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The initial input control value is all bits clear. 

The c_oflag field specifies the system treatment of output: 



OPOST 


0000001 


Postprocesses output 


OLCUC 


0000002 


Maps lowercase to uppercase on output 


ONLCR 


0000004 


Maps NL to CR-NL on output 


OCR NT 


0000010 


Mans CR to NT. on outniit 


ONOCR 


0000020 


No CR output at column 


ONLRET 


0000040 


NL performs CR function 


OFELL 


0000100 


Uses fill characters for delay 


OFDEL 


0000200 


Fills is DEL, else NUL 


NLDLY 

NLO 

NL1 


0000400 

Q 

0000400 


Selects newline delays: 


CRDLY 

CRO 

CRl 

CR3 


0003000 


0001000 
uuuzuuu 
0003000 


Selects carriage return delays: 


TABDLY 
TABO 
TABl 
TAB 2 
TAB 3 


0014000 


0004000 
0010000 
0014000 


Selects horizontal tab delays: 
Expands tabs to spaces 


BSDLY 

BSO 

BSl 


0020000 


0020000 


Selects backspace delays: 


VTDLY 

VTO 

VT1 


0040000 


0040000 


Selects vertical tab delays: 


FFDLY 

FFO 

FFl 


0100000 


0100000 


Selects form feed delays: 



If OPOST is set, output characters are post-processed as indicated by 
the remaining flags, otherwise characters are transmitted without 
change. 

If OLCUC is set, a lowercase alphabetic character is transmitted as the 
corresponding uppercase character. This function is often used in con- 
junction with IUCLC. 
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If ONLCR is set, the NL character is transmitted as the CR-NL charac- 
ter pair. If OCRNL is set, the CR character is transmitted as the NL 
character. If ONOCR is set, no CR character is transmitted when at 
column (first position). If ONLRET is set, the NL character is 
assumed to perform the carriage return function and the column 
pointer is set to and the delays specified for CR will be used. Other- 
wise, the NL character is assumed to perform the linefeed function; 
the column pointer will remain unchanged. The column pointer is 
also set to if the CR character is actually transmitted. 

The delay bits specify how long transmission stops to allow for 
mechanical or other movement when certain characters are sent to the 
terminal. In all cases, a value of indicates no delay. If OFILL is set, 
fill characters will be transmitted for delay instead of a timed delay. 
This is useful for high baud rate terminals which need only a minimal 
delay. If OFDEL is set, the fill character is DEL, otherwise NUL. 

If a form feed or vertical tab delay is specified, it lasts for about 2 
seconds. 

Newline delay lasts about 0.10 seconds. If ONLRET is set, the car- 
riage return delays are used instead of the newline delays. If OFILL is 
set, 2 fill characters will be transmitted. 

Carriage return delay type 1 is dependent on the current column posi- 
tion, type 2 is about 0.10 seconds, and type 3 is about 0.15 seconds. If 
OFILL is set, delay type 1 transmits 2 fill characters, and type 2 
transmits 4 fill characters. 

Horizontal tab delay type 1 is dependent on the current column posi- 
tion. Type 2 is about 0.10 seconds. Type 3 specifies that tabs are to be 
expanded into spaces. If OFILL is set, 2 fill characters will be 
transmitted for any delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, 1 fill char- 
acter will be transmitted. 

The actual delays depend on line speed and system load. 

The initial output control value is all bits clear. 

The c_cflag field describes the hardware control of the terminal: 



CBAUD 


0000017 


Baud rate: 


B0 





Hang up 


B50 


0000001 


50 baud 


B75 


0000002 75 baud 


B110 


0000003 


110 baud 


B134 


0000004 


134.5 baud 


B150 


0000005 


150 baud 


B200 


0000006 200 baud 


B300 


0000007 


300 baud 
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B600 


0000010 


600 baud 


B1200 


0000011 


1200 baud 


B1800 


0000012 


1800 baud 


B2400 


0000013 


2400 baud 


B4800 


0000014 


4800 baud 


B9600 


0000015 


9600 baud 


PVTA 


VJUWUVJ J. o 


JQAlCHlal t\ 


PYTR 
EA 1 D 




\-i v totn o 1 H 
JJ/AlCIIlal D 


CSIZE 


0000060 


Character size: 


CS5 





5 bits 


CS6 


0000020 


6 bits 


CS7 


0000040 


7 bits 


CS8 


0000060 


8 bits 


CSTOPB 


0000100 


Sends two stop bits, else one 


CREAD 


0000200 


Enables receiver 


PARENB 


0000400 


Parity enable 


PARODD 


0001000 


Odd parity, else even 


HUPCL 


0002000 


Hangs up on last close 


CLOCAL 


0004000 


Local line, else dial-up 


LOBLK 


0010000 


Block layer output 



The CBAUD bits specify the baud rate. The zero baud rate, B0, is used 
to hang up the connection. If B0 is specified, the data-terminal-ready 
signal will not be asserted. Without this signal, the line is discon- 
nected if it is connected through a modem. For any particular 
hardware, impossible speed changes are ignored. 

The CSIZE bits specify the character size in bits for both transmission 
and reception. This size does not include the parity bit, if any. If 
CSTOPB is set, 2 stop bits are used, otherwise 1 stop bit. For example, 
at 1 10 baud, 2 stops bits are required. 

If PARENB is set, parity generation and detection is enabled and a par- 
ity bit is added to each character. If parity is enabled, the PARODD 
flag specifies odd parity if set, otherwise even parity is used. 

If CREAD is set, the receiver is enabled. Otherwise no characters will 
be received. 

If HUPCL is set, the line will be disconnected when the last process 
with the line open closes it or terminates. That is, the data-terminal- 
ready signal will not be asserted. 

If CLOCAL is set, the line is assumed to be a local, direct connection 
with no modem control. The data-terminal-ready and request-to-send 
signals are asserted, but incoming modem signals are ignored. If 
CLOCAL is not set, modem control is assumed. This means the data- 
terminal-ready and request-to-send signals are asserted. Also, the 
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carrier-detect signal must be returned before communications can 
proceed. 

If LOBLK is set, the output of a job control layer will be blocked when 
it is not the current layer. Otherwise the output generated by that 
layer will be multiplexed onto the current layer. 

The initial hardware control value after open is B9600, CS8, CREAD, 
HUPCL. 



The cjflag field of the argument structure is used by the line discip- 
line to control terminal functions. The basic line discipline (0) pro- 
vides the following: 



ISIG 0000001 Enable signals 

ICANON 0000002 Canonical input (erase and kill processing) 

XCASE 0000004 Canonical upper/lower presentation 

ECHO 0000010 Enables echo 

ECHOE 0000020 Echoes erase character as BS-SP-BS 

ECHOK 0000040 Echoes NL after kill character 

ECHONL 0000100 Echoes NL 

NOFLSH 0000200 Disables flush after interrupt or quit 

XCLUDE 1 00000 Exclusive use of the line 



If ISIG is set, each input character is checked against the special con- 
trol characters INTR, SWTCH, and QUIT. If an input character 
matches one of these control characters, the function associated with 
that character is performed. If ISIG is not set, no checking is done. 
Thus, these special input functions are possible only if ISIG is set. 
These functions may be disabled individually by changing the value of 
the control character to an unlikely or impossible value (e.g., 0377). 

If ICANON is set, canonical processing is enabled. This enables the 
erase and kill edit functions, and the assembly of input characters into 
lines delimited by NL, EOF, and EOL. If ICANON is not set, read 
requests are satisfied directly from the input queue. A read will not be 
satisfied until at least VMIN characters have been received or the 
timeout value VTIME has expired and at least one character has been 
input. This allows fast bursts of input to be read efficiently while still 
allowing single character input. (See the discussion of VMIN and 
VTIME below.) 

The VMIN and VTIME values are stored in the position for the EOF 
and EOL characters respectively. VMIN and VTIME are interpreted as 
EOF and EOL if ICANON is set. Default VMLN and VTIME values are 
stored in the /usr/include/sys/termio.h file. To change these values, 
set ICANON to off and use stty(C) to change the VMIN and VTIME 
values as represented by EOF and EOL. The TIME value represents 
tenths of seconds. 
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If XCASE and ICANON are set, an uppercase letter is accepted on 
input by preceding it with a \ character, and is output preceded by a \ 
character. In this mode, the following escape sequences are generated 
on output and accepted on input: 

For: Use: 



For example, A is input as \a, \n as \\n, and \N as \\\n. 

If ECHO is set, characters are echoed as received. 

When ICANON is set, the following echo functions are possible. If 
ECHO and ECHOE are set, the erase character is echoed as ASCII BS 
SP BS, which will clear the last character from a CRT screen. If 
ECHOE is set and ECHO is not set, the erase character is echoed as 
ASCII SP BS. If ECHOK is set, the NL character will be echoed after 
the kill character to emphasize that the line will be deleted. Note that 
an escape character preceding the erase or kill character removes any 
special function. If ECHONL is set, the NL character will be echoed 
even if ECHO is not set. This is useful for terminals set to local echo 
(so-called half duplex). Unless escaped, the EOF character is not 
echoed. Because EOT is the default EOF character, this prevents ter- 
minals that respond to EOT from hanging up. 

If NOFLSH is set, the normal flush of the input and output queues asso- 
ciated with the quit and interrupt characters will not be done. 

If XCLUDE is set, any subsequent attempt to open the TTY device 
using open(S) will fail for all users except the super-user. If the call 
fails, it returns EBUSY in errno. XCLUDE is useful for programs 
which must have exclusive use of a communications line. It is not 
intended for the line to the program's controlling terminal. XCLUDE 
must be cleared before the setting program terminates, otherwise sub- 
sequent attempts to open the device will fail. 

VMIN represents the minimum number of characters that should be 
received when the read is satisfied (i.e., the characters are returned to 
the user). VTIME is a timer of 0.10 second granularity used to time-out 
bursty and short-term data transmissions. The four possible values for 
VMIN and VTIME and their interactions are: 

VMIN > 0, VTIME > 

In this case, VTIME serves as an inter-character timer activated after 
the first character is received, and reset upon receipt of each character. 
VMIN and VTIME interact as follows: 



{ 
} 

\ 



\! 

\( 
\) 

w 
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As soon as one character is received the inter-character timer is 
started. 



If VMIN characters are received before the inter-character timer 
expires the read is satisfied. 

If the timer expires before VMIN characters are received the char- 
acters received to that point are returned to the user. 

A read(S) operation will sleep until the VMIN and VTIME mechan- 
isms are activated by the receipt of the first character; thus, at least 
one character must be returned. 



VMIN > 0, VTIME = 

In this case, because VTIME = 0, the timer plays no role and only 
VMIN is significant. A read(S) operation is not satisfied until VMIN 
characters are received. 



VMIN = 0, VTIME > 

In this case, because VMIN = 0, VTIME no longer serves as an inter- 
character timer, but now serves as a read timer that is activated as 
soon as the read(S) operation is processed. A read(S) operation is 
satisfied as soon as a single character is received or the timer expires, 
in which case, the read(S) operation will not return any characters. 

VMIN = 0, VTIME = 

In this case, return is immediate. If characters are present, they will 
be returned to the user. 



The initial line-discipline control value is all bits clear. 

The primary ioctl(S) system calls have the form: 

ioctl (fildes, command, arg) 
struct termio *arg; 

The commands using this form are: 

TCGETA Gets the parameters associated with the terminal and 
stores them in the termio structure referenced by arg. 



TCSETA Sets the parameters associated with the terminal from 
the structure referenced by arg. The change is 
immediate. 



TCSETAW Waits for the output to drain before setting the new 
parameters. This form should be used when changing 
parameters that will affect output. 

TCSETAF Waits for the output to drain, then flushes the input 
queue and sets the new parameters. 
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Additional ioctl(S) calls have the form: 

ioctl (hides, command, arg) 
int arg; 

The commands using this form are: 

TCSBRK Waits for the output to drain. If arg is 0, then sends a 
break (zero bits for 0.25 seconds). 

TCXONC Starts/stops control. If arg is 0, suspends output; if 1, 
restarts suspended output. 

TCFLSH If arg is 0, flushes the input queue; if 1, flushes the 
output queue; if 2, flushes bom the input and output 
queues. 

Files 

/dev/tty 

/dev/tty* 

/dev/console 

See Also 

fork(S), ioctl(S), mapchan(F), mapchan(M), read(S), setgprp(S), 
signal(S), stty(C), tty(M) 
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Name 

trchan - Translate character sets 



Syntax 

trchan [-ciko] mapfile 



Description 

trchan performs mapping as a filter, using the same format of mapfile 
as mapchan(M) (described in mapchan(¥)). This allows a file consist- 
ing of one internal character set to be "translated' ' to another internal 
character set. 

trchan reads standard input, maps it, and writes to standard output. A 
mapfile must be given on the command line. Errors cause trchan to 
stop processing unless -c is specified. 

The following options can be used with trchan : 

-c causes errors to be echoed on stderr, and processing is continued. 

-i specifies that the "input" section of the mapfile is used when 
translating data. 

-k specifies that the "dead" and "compose" sections of the mapfile 
are used when translating data. 

-o specifies that the "output" section of the mapfile is used when 
translating data. 

The -i, -k and -o options can be specified in any combination; if 
none are specified, trchan uses the entire mapfile, as if all three 
were specified together. 



Files 

/usr/lib/mapchan/ : 



See Also 

ascii(M), mapchan(F), mapchan(M) 



Notes 

trchan currently ignores the control sections of the mapfile. 
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Name 

tty - Special terminal interface. 



Description 

The file /dev/tty is, in each process, a synonym for the control termi- 
nal associated with the process group of that process, if any. It is use- 
ful for programs or shell sequences that wish to be sure of writing 
messages on the terminal no matter how output has been redirected. It 
can also be used for programs that demand the name of a file for out- 
put, when typed output is desired, and when it is tiresome to find out 
what terminal is currently in use. 

The general terminal interface is described in termio (M). 



Files 

/dev/tty 
/dev/tty* 



See Also 

termio(M) 
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Name 

TZ - Time zone environment variable. 
Syntax 

TZ=sssn[ddd[m][;start[/time],end[/time] ]] ; export TZ 
setenv TZ sssn[ddd[m][;start[/time],end[/time] ]] 
/etc/tz 

Description 

TZ is the shell environment variable for the time zone of the system 
and is set in the files /etc/rc, /.profile, and /etc/default/login. 

The shell script /etc/tz, generally run during installation, prompts for 
the correct time zone and makes the changes in the appropriate files. 

/etc/tz also prompts for the dates when time is shifted from standard to 
daylight time and back, and for the number of hours to shift (partial 
hours in the form of hh:mm:ss are acceptable). 

Users living in a time zone different than that of the host machine may 
change TZ in their $HOME/.profile or $HOME/.login files. 



TZ contains the following information: 



(sss) One to nine letters designating the standard time zone. 

(n) Number of hours past Greenwich mean time for the stan- 

dard time (partial hours are valid e.g. 12:30:01). Positive 
hours are west of Greenwich, negative numbers are east of 
Greeenwich. 



(ddd) One to nine letters designating the local daylight savings 
time (summer time) zone. If not present, summer time is 
assumed not to apply. 

(m) Number of hours past Greenwich mean time for the sum- 

mer time (partial hours are valid e.g. 11:30:01). Positive 
hours are west of Greenwich, negative numbers are east of 
Greeenwich. If m is not given, the distance to GMT dur- 
ing summer time is assumed to be one hour less than dur- 
ing standard time. 



(start) The rule defining the day summer time begins. In the 
southern hemisphere, the ending day will be earlier in the 
year than the starting day. 



May 16, 1988 



Page 1 



TZ(M) iZ(M; 

(end) The rule defining the day summer time ends. 

(time) The time of day the change to and from summer time 
occurs. The default is 02:00:00 local time. 

The rules for defining the start and end of summer time are as fol- 
lows: 

Jn 1 based Julian day n (1 < n < 365)* 

n based Julian day n (0 < n < 364)* 

Wn.d day d (0 < d < 6)** of week n (1 < n < 53)t 

Mm.n.d day d of week n (1 < n < 5)% of month m(l <m< 12) 



* Leap days (February 29) are never counted; that is, February 28 
(J59) is immediately followed by March 1 (J60) even in leap years. 

** Sunday is the first day of the week (0). If d is omitted, Sunday is 
assumed. Note that d is optional. 

f The 5th week of the month is always the last week containing day 
d, whether there are actually 4 or 5 weeks containing day d. 

$ The 53rd week of the year is always the last week containing day 
d, whether there are actually 52 or 53 weeks containing day d. 

If start and end are omitted, current U.S. law is assumed. 

For the simple expression of Eastern Standard/Daylight Time TZ is set 
as follows: 

TZ=EST5EDT ; export TZ 
(forsA(C)andvs/i(C)) 

setenv TZ EST5EDT 
(for csh(C)) 

The fully expressed TZ string for Eastern Standard/Daylight Time, 
using the current U.S. law of changing to daylight saving time on the 
first Sunday in April, and back to standard time on the last Sunday in 
October at 2:00 a.m. local time, would be: 

TZ=EST05 :00:00EDT04:00:00;M4. 1 .0/02:00:00,M10.5.0/02:00:00 

To change the time zone for the entire system, run the shell script 
/etc/tz (as root) or use an editor to change the variable TZ in the files 
/etc/rc, /.profile and /etc/default/login. In /etc/rc the line changing 
the time zone (see the sh example above) must occur before the 
/etc/asktime command. The TZ variable in /etc/default/login causes 
the time zone to be set correctly on logging in and for programs such 
as uucico . 
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Files 

/etc/rc 

/etc/default/login 
/etc/tz 

$HOME/.profile 
$HOME/.login 

See Also 

environ(M), date(C), ctime(S) 



Notes 

The date(C) automatically switches from Standard Time to Summer 
Time (Daylight Saving Time). Leap days are properly accounted for. 

Changes to TZ are immediately effective, (i.e. if a process changes the 
TZ variable, the next call to a ctime (S) routine returns a value based 
on the new value of the variable). 
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Name 

intro - Introduction to file formats. 
Description 

This section outlines the formats of various files. Usually, these struc- 
tures can be found in the directories /usr/include or /usr/include/sys. 
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Name 

86rel - Intel 8086 Relocatable Format for Object Modules. 



Syntax 

#include <sys/relsym86.h> 



Description 

Intel 8086 Relocatable Format, or 86rel, is the object module format 
generated by masm(CP), and the input format for the linker ld(CP). 
The include file relsym86.h specifies appropriate definitions to access 
86rel format files from C. For the technical details of the 86rel for- 
mat, see Intel 8086 Object Module Format External Product Specifi- 
cation . 

An 86rel consists of one or more variable length records. Each record 
has at least three fields: the record type, length, and checksum. The 
first byte always denotes the record type. There are thirty-one dif- 
ferent record types. Only eleven are used by ld(CP) and masm(CP). 
The word after the first byte is the length of the record in bytes, 
exclusive of the first three bytes. Following the length word are typi- 
cally one or more fields. Each record type has a specific sequence of 
fields, some of which may be optional or of varying length. The very 
last byte in each record is a checksum. The checksum byte contains 
the sum modulo 256 of all other bytes in the record. The sum modulo 
256 of all bytes in a record, including the checksum byte, should equal 
zero. 

With few exceptions, 86rel strings are length prefixed and have no 
trailing null. The first byte contains a number between and 40, 
which is the remaining length of the string in bytes. Although the 
Intel specification limits the character set to upper case letters, digits, 
and the characters "?", "@", and masm(CP) uses the 

complete ASCII character set. 

The Intel Object Module Format (OMF) specification uses the term 
"index" to mean a positive integer either in the range to 127, or 128 
to 32,768. This terminology is retained in this document and else- 
where in the 86rel literature. An index has one or two bytes. If the 
first byte has a leading bit, the index is assumed to have only one 
byte, and the remainder of the byte represents a positive integer 
between and 127. If the second byte has a leading 1 bit, the index is 
assumed to take up two bytes, and the remainder of the word 
represents a positive integer between 128 and 32,768. 
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Following is a list of record types and the hexadecimal value of their 
first byte, as defined in relsym86.h. 

#define MRHEADR 0x6e /*rel module header/* 

#define MREGINT 0x70 ^register initialization*/ 

#define MREDATA 0x72 /*explicit (enumerated) data image*/ 

#define MRIDATA 0x74 /*repeated (iterated) data image*/ 

#define MOVLDEF 0x76 /*overlay definition*/ 

#define MENDREC 0x78 /*block or overlay end record*/ 

#define MBLKDEF 0x7a /*block definition*/ 

#define MBLKEND 0x7c /*block end*/ 

#define MDEBSYM 0x7e /*debug symbols*/ 

#define MTHEADR 0x80 /*module header, 

*usually first in a rel file*/ 
#define MLHEADR 0x82 /*link module header*/ 
#define MPEDATA 0x84 /*absolute data image*/ 
#define MPIDATA 0x86 /*absolute repeated (iterated) 

*data image*/ 

#define MCOMENT 0x88 /*comment record*/ 

#define MMODEND 0x8a /*module end record*/ 

#define MEXTDEF 0x8c /*external definition*/ 

#define MTYPDEF 0x8e /*type definition*/ 

#define MPUBDEF 0x90 /*public definition*/ 

#define MLOCSYM 0x92 /*local symbols*/ 

#define MLINNUM 0x94 /*source line number*/ 

#define MLNAMES 0x96 /*name list record*/ 

#define MSEGDEF 0x98 /*segment definition*/ 

#define MGRPDEF 0x9a /*group definition*/ 

#define MFIXUPP 0x9c /*fix up previous data image*/ 

#define MNONE1 0x9e /*none*/ 

#define MLEDATA OxaO /* logical data image*/ 

#define MLIDATA 0xa2 /*logical repeated (iterated) 

*data image*/ 
#define MLIBHED 0xa4 /*library header*/ 
#define MLIBNAM 0xa6 /*library names record*/ 
#define MLIBLOC 0xa8 /*library module locations*/ 
#define MLIBDIC Oxaa /*library dictionary*/ 
#define M386END 0x86 /*32 bit module end record*/ 
#define MPUB386 0x9 1 /*32 bit public definition*/ 
#define MLOC386 0x93 /*32 bit logical symbols*/ 
#define MLIN386 0x95 /*32 bit source line number*/ 
#define MSEG386 0x99 /*32 bit segment definition*/ 
#define MFIX386 0x9d /*fix up previous 32 bit data image*/ 
#define MLED386 Oxal /*32 bit logical data image*/ 
#define MLID386 0xa3 /*32 bit logical repeated (iterated) data ima£ 

In the following discussion, the salient features of each record type are 
given. If the record is not used by either masm(CP) or Id (CP), it is not 
listed. 
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THEADR The record type byte is 0x80. The THE ADR record 
specifies the name of the source module at assembly- 
time (see Notes). The sole field is the T-MODULE 
NAME , which contains a length-prefixed string 
derived from the base name of the source module. 

COMENT The record type byte is 0x88. The COMENT record 
may contain a remark generated by the compiler sys- 
tem. mams{C?) inserts the string "XENIX 8086 
ASSEMBLER ." 

MODEND The record type byte is 0x8a. The MODEND record 
terminates a module. It can specify whether the 
current module is to be used as the entry point to the 
linked executable. If the module is an entry point, the 
MODEND record can then specify the address of the 
entry point within the executable. 

EXTDEF The record type byte is 0x8c. The EXTDEF record 

contains the names and types of symbols defined in 
other modules by a PUBDEF record (see below). This 
corresponds to the C storage class "extern." The 
fields consist of one or more length-prefixed strings, 
each with a following type index. The indices refer- 
ence a TYPDEF record seen earlier in the module, 
masm (CP) generates only one EXTDEF per exterior 
symbol. 

TYPDEF The record type byte is 0x8e. The TYPDEF record 
gives a description of the type (size and storage attri- 
butes) of an object or objects. This description can 
then be referenced by EXTDEF , PUBDEF , and other 
records. 

PUBDEF The record type byte is 0x90. The PUBDEF record 

gives a list of one or more names that may be refer- 
enced by other modules at link-time ("publics"). The 
list of names is preceded by a group and segment 
index, which reference the location of the start of the 
list of publics within the current segment and group. 
If the segment and group indices are zero, a frame 
number is given to provide an absolute address in the 
module. The list consists of one or more of length- 
prefixed strings, each associated with a 16-bit offset 
within the current segment and a type index referring 
to a TYPDEF . 



LNAMES The record type byte is 0x96. The LNAMES record 
gives a series of length-prefixed strings which are 
associated with name indices within the current 
module. Each name is indexed in sequence given 
starting with 1. The names may then be referenced 
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within the current module by successive SEGDEF and 
GRPDEF records to provide strings for segments, 
classes, overlays or groups. 

SEGDEF The record type byte is 0x98. The SEGDEF record pro- 
vides an index to reference a segment, and informa- 
tion concerning segment addressing and attributes. 
This index may be used by other records to refer to the 
segment. The first word in the record after the length 
field gives information about the alignment, and about 
combination attributes of the segment. The next word 
is the segment length in bytes. Note that this restrains 
segments to a maximum 645,536 bytes in length. Fol- 
lowing this word is an index (see above) for the seg- 
ment. Lastly, the SEGDEF may optionally contain 
class and/or overlay index fields. 

GRPDEF The record type is 0x9a. The GRPDEF record provides 
a name to reference several segments. The group 
name is implemented as an index (see above). 

FDCUPP The record byte is 0x9c. The FEXUPP record specifies 

one or more load-time address modifications 
("fixups"). Each fixup refers to a location in a 
preceding LEDATA (see below) record. The fixup is 
specified by four data; a location, a mode, a target and 
a frame. The frame and target may be specified expli- 
citly or by reference to an already defined fixup. 

LEDATA The record type byte is OxaO. This record provides a 
contiguous text or data image which the loader Id (CP) 
uses to construct a portion of an 8086 run-time execut- 
able. The image might require additional processing 
(see FIXUPP) before being loaded into the executable. 
The image is preceded by two fields, a segment index 
and an enumerated data offset. The segment index 
(see INDEX) specifies a segment given by a previously 
seen SEGDEF . The enumerated data offset (a word) 
specifies the offset from the start of this segment. 

See Also 

as(CP), ld(CP) 
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Notes 

If you attempt to load a number of modules assembled under the same 
basename, the loader will try to put them all in one big segment. In 
286 programs, segment size is limited to 64K. In a large program the 
resulting segment size can easily exceed 64K. A large model code 
executable results from the link of one or more modules, composed of 
segments that aggregate into greater than 64K of text. 

Hence, be sure that the assembly-time name of the module has the 
same basename as the source. This can occur if the source module is 
preprocessed not by cc (CP), but, for example, by hand or shell script, 
prior to assembly. The following example is incorrect: 

#incorrect 

cc -E module l.c I filter > x.c 
cc x.c 

mv x.o module l.o 

cc -E module2.c I filter > x.c 

cc x.c 

mv x.o module2.o 

cc -E module3.c I filter > x.c 

cc x.c 

mv x.o module3.o 

Id modulel.o module2.o module3.o 



To avoid this, each of the modules should have a unique name when 
assembled, as follows: 

#correct 

cc -E module l.c I filter > x.c 
cc -S x.c 

mv x.s module l.s 
as module l.s 



Id modulel.o module2.o module3.o 
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Name 

a.out - Format of assembler and link editor output. 



Description 

A.out is the output file of the assembler masm and the link editor Id. 
Both programs will make a.out executable if there were no errors in 
assembling or linking, and no unresolved external references. 

The format of a.out, called the x.out or segmented x.out format, is 
defined by the files /usr/include/a.out.h and 
/usr/include/sys/relsym.h. The a.out file has the following general 
layout: 

1. Header. 

2. Extended header. 

3. File segment table (for segmented formats). 

4. Segments (Text, Data, Symbol, and Relocation). 

In the segmented format, there may be several text and data segments, 
depending on the memory model of the program. Segments within the 
file begin on boundaries which are multiplies of 512 bytes as defined 
by the file's pagesize. 



Format 

/* 

* The main and extended header structures. 

* For x.out segmented (XE_SEG): 

* 1) fields marked with (s) must contain sums of xs_psize for 

* non-memory images, or xs_vsize for memory images. 

* 2) the contents of fields marked with (u) are undefined. 
*/ 

struct xexec { /* x.out header */ 

unsigned short x_magic; /* magic number */ 
unsigned short x_ext; /* size of header extension */ 



long 


x_text; 


/* size of text segment (s) */ 


long 


x_data; 


/* size of initialized data (s) */ 


long 


x_bss; 


/* size of uninitialized data (s) */ 


long 


x_syms; 


/* size of symbol table (s) */ 


long 


x_reloc; 


/* relocation table length (s) */ 


long 


x_entry; 


/* entry point, machine dependent */ 
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char 


x_cpu; /* 


cpu type & byte/word order */ 


char 


x_relsym; /* 


relocation & symbol format (u) */ 


unsigned 

}; 


short x_renv; 


/* run-time environment */ 


struct xext { 




/* x.out header extension */ 


long 


xe_trsize; 


/* size of text relocation (s) */ 


long 


xe_drsize; 


/* size of data relocation (s) */ 


long 


xe_tbase; 


/* text relocation base (u) */ 


long 


xe_dbase; 


/* data relocation base (u) */ 


long 


xe_stksize; 


/* stack size (if XEJFS set) */ 




/* the following must be present if XEJSEG */ 


long 


xe_segpos; 


/* segment table position */ 


long 


xe_segsize; 


/* segment table size */ 


long 


xe_mdtpos; /* 


machine dependent table position */ 


long 


xejmdtsize;/* 


machine dependent table size */ 


char 


xe_mdttype; 


/* machine dependent table type */ 


char 


xe_pagesize; 


/* file pagesize, in multiples of 512 */ 


char 


xe_ostype; 


/* operating system type */ 


char 


xe_osvers; 


/* operating system version */ 


unsigned 


short xe_eseg; 


/* entry segment, machine dependent */ 


unsigned 

}; 


short xe_sres; 


/* reserved */ 


struct xseg { 


/* x.out segment table entry */ 


unsigned 


short xs_type; 


/* segment type */ 


unsigned 


short xs_attr; /* 


segment attributes */ 


unsigned 


short xs_seg; 


/* segment number */ 


char 


xs_align; 


/* log base 2 of alignment */ 


char 


xs_cres; 


/* unused */ 


long 


xs_filpos; 


/* file position */ 


long 


xs_psize; 


/* physical size (in file) */ 


long 


xs_vsize; 


/* virtual size (in core) */ 


long 


xs_rbase; 


/* relocation base address/offset */ 


unsigned 


short xs_noff,/* 


segment name string table offset */ 


unsigned 


short xs_sres;/* 


unused */ 


long 

}; 


xs_lres; /* 


unused */ 


struct xiter { 


/* 


x.out iteration record */ 


long 


xi_size; /* 


source byte count */ 


long 


xi_rep; /* 


replication count */ 


long 


xi_offset; /* 


destination offset in segment */ 



}; 
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struct xlist 



unsigned short xljype; 
unsigned short xl_seg; 
long xl_value; 
char *xl_name; 



/* xlist structure for xlist(3). */ 
/* symbol type */ 
/* file segment table index */ 
/* symbol value */ 
/* pointer to asciz name */ 



struct aexec { /* a.out header */ 

unsigned short xa_magic; /* magic number */ 

unsigned short xa_text; /* size of text segment */ 

unsigned short xa_data; /* size of initialized data */ 

unsigned short xa_bss; /* size of uninitialized data */ 

unsigned short xa_syms; /* size of symbol table */ 

unsigned short xa_entry; /* entry point */ 

unsigned short xa_unused; /* not used */ 

unsigned short xa_flag; /* relocation info stripped */ 



struct nlist { /* nlist structure for nlist(3). */ 

char n_name[8]; /* symbol name */ 

int n_type; /* type flag */ 

unsigned n_valiie; /* value */ 



struct bexec { /* b.out header */ 

long xb_magic; /* magic number */ 

long xb_text; /* text segment size */ 

long xb_data; /* data segment size */ 

long xb_bss; /* bss size */ 

long xb_syms; /* symbol table size */ 

long xb_trsize; /* text relocation table size */ 

long xb_drsize; /* data relocation table size */ 

long xb_entry; /* entry point */ 



See Also 

masm(CP), ld(CP), nm(CP), strip(CP), xlist(S). 
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Name 

acct - Format of per-process accounting file. 



Description 

Files produced as a result of calling acct(S) have records in the form 
defined by <sys/acct.h>. 

In ac Jlag , the AFORK flag is turned on by each fork(S) and turned off 
by an exec (S). The ac_comm field is inherited from the parent pro- 
cess and is reset by any exec . Each time the system charges the pro- 
cess with a clock tick, it also adds the current process size to acjnem 
computed as follows: 

(data size) + (text size) / (number of in-core processes using text) 

The value of acjnem I acjstime can be viewed as an approximation to 
the mean process size, as modified by text-sharing. 



See Also 

acctcom(ADM), acct(S) 



Notes 

The acjnem value for a short-lived command gives little information 
about the actual size of the command, because acjnem may be incre- 
mented while a different command (e.g., the shell) is being executed 
by the process. 
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Name 

ar - Archive file format. 



Description 

The archive command ar is used to combine several files into one. 
Archives are used mainly as libraries to be searched by the link editor 
ld(C). 

A file produced by ar has a magic number at the start, followed by the 
constituent files, each preceded by a file header. The magic number is 
0177545 octal (or 0xff65 hexadecimal). The header of each file is 
declared in /usr/include/ar.h. 

Each file begins on a word boundary; a null byte is inserted between 
files if necessary. Nevertheless the size given reflects the actual size 
of the file exclusive of padding. 

Notice there is no provision for empty areas in an archive file. 



See Also 

ar(CP), ld(CP) 
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Name 

archive - Default backup device information. 
Description 

I etc/ default! archive contains information on system default backup 
devices for use by sysadmin(ADM). The device entries are in the fol- 
lowing format: 

name=value [name= value] ... 

value may contain white spaces if quoted, and newlines may be 
escaped with a backslash. 

The following names are defined for /etc/ default/ archive: 



bdev Name of the block interface device. 

cdev Name of the character interface device. 

size Size of the volume in either blocks or feet. 

density Volume density, such as 1600. If this value is miss- 

ing or null, then size is in blocks; otherwise the size 
is in feet. 

format Command used to format the archive device, 

blocking Blocking factor. 

desc A description of the device, such as "Cartridge 

Tape." 



See Also 

sysadmin(ADM) 
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Name 

backup - Incremental dump tape format. 
Description 

The backup and restore commands are used to write and read incre- 
mental dump magnetic tapes. 

The backup tape consists of a header record, some bit mask records, a 
group of records describing file system directories, a group of records 
describing file system files, and some records describing a second bit 
mask. 

The header record and the first record of each description have the for- 
mat described by the structure included by: 

#include <dumprestor.h> 

Fields in the dumprestor structure are described below. 

NTREC is the number of 512 byte blocks in a physical tape record. 
MLEN is the number of bits in a bit map word. MSIZ is the number of 
bit map words. 

The TS_ entries are used in the cjype field to indicate what sort of 
header this is. The types and their meanings are as follows: 

TS_TYPE Tape volume label. 

TS_INODE A file or directory follows. The c_dinode field is a 
copy of the disk inode and contains bits telling what 
sort of file this is. 

TS_BITS A bit mask follows. This bit mask has one bit for each 
inode that was backed up. 

TS_ADDR A subblock to a file (TS INODE). See the description 
of c_count below. 

TS_END End of tape record. 

TS_CLRI A bit mask follows. This bit mask contains one bit for 
all inodes that were empty on the file system when 
backed up. 

MAGIC All header blocks have this number in cjnagic . 

CHECKSUM Header blocks checksum to this value. 
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The fields of the header structure are as follows: 



c_type The type of the header. 

c_date The date the backup was taken. 

c_ddate The date the file system was backed up. 

c_volume The current volume number of the backup. 

c_tapea The current block number of this record. This is count- 

ing 512 byte blocks. 

c_inumber The number of the inode being backed up if this is of 
type TSJNODE. 

c_magic This contains the value MAGIC above, truncated as 
needed. 

c_checksum This contains whatever value is needed to make the 
block sum to CHECKSUM. 



c_dinode This is a copy of the inode as it appears on the file sys- 
tem. 



c_count The following count of characters describes the file. 

A character is zero if the block associated with that 
character was not present on the file system; other- 
wise, the character is nonzero. If the block was not 
present on the file system no block was backed up and 
it is replaced as a hole in the file. If there is not 
sufficient space in this block to describe all of the 
blocks in a file, TS_ADDR blocks will be scattered 
through the file, each one picking up where the last 
left off. 



c_addr This is the array of characters that is used as described 

above. 



Each volume except the last ends with a tapemark (read as an end of 
file). The last volume ends with a TS_END block and then the tape- 
mark. 



The structure idates describes an entry of the file where backup his- 
tory is kept. 



See Also 

backup(C), restore(C), filesystem(F) 
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Name 

checklist - List of file systems processed by fsck. 



Description 

The /etc/checklist file contains a list of the file systems to be checked 
when fsck( ADM) is invoked without arguments. The list contains at 
most 15 special file names. Each special file name must be on a 
separate line and must correspond to a file system. 



See Also 

fsck(ADM) 
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Name 

clock - The system real-time (time of day) clock. 



Description 

The clock file provides access to the battery-powered, real-time time 
of day clock. Reading this file returns the current time; writing to the 
file sets the current time. The time, 10 bytes long, has the following 
form: 

MMddhhmmyy 

where MM is the month, dd is the day, hh is the hour, mm is the 
minute, and yy is the last two digits of the year. For example, the time: 
0826150385 is 15:03 on August 26, 1985. 



Files 

/dev/clock 



See Also 

setclock(ADM) 



Notes 

Not all computers have battery-powered real-time time of day clocks. 
Refer to your computer's hardware reference manual. 
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Name 

core - Format of core image file. 



Description 

XENIX writes out a core image of a terminated process when any of 
various errors occur. See signal (S) for the list of reasons; the most 
common are memory violations, illegal instructions, bus errors, and 
user-generated quit signals. The core image is called core and is writ- 
ten in the process' working directory (provided it can be; normal 
access controls apply). A process with an effective user ID different 
from the real user ID will not produce a core image. 

The first section of the core image is a copy of the system's per-user 
data for the process, including the registers as they were at the time of 
the fault. The size of this section depends on the parameter usize, 
which is defined in /usr/include/sys/param.h. The remainder 
represents the actual contents of the user's core area when the core 
image was written. If the text segment is read-only and shared, or 
separated from data space, it is not dumped. 

The format of the information in the first section is described by the 
user structure of the system, defined in /usr/include/sys/user.h. The 
locations of registers, are outlined in /usr/include/sys/reg.h. 



See Also 

adb(CP), setuid(S), signal(S) 
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Name 

cpio - Format of cpio archive. 



Description 

The header structure, when the c option is not used, is: 
struct { 

short hjnagic, 

h_dev, 

h_ino, 

hjmode, 

h_uid, 

h_gid, 

h_nlink, 

h_rdev, 

h_mtime[2], 

h_namesize, 

h_filesize[2]; 
char h_name[h_namesize rounded to word]; 

}Hdr; 

When the c option is used, the header information is described by the 
statement below: 

sscanf(Chdr,"%6o%6o%6o%6o%6o%6o%6o%6o% 1 llo%6o% 1 llo%s", 
&Hdr.h_magic,&Hdr.h_dev,«feHdr.h_ino,&Hdr.h_mode, 
&Hdr.h_uid,&Hdr.h_gid,&Hdr.h_nlink,&Hdr.h_rdev, 
&Longtime,&Hdr.h_namesize,&Longfile,Hdr.h_name); 

Longtime and Longfile are equivalent to Hdr.hjntime and 
Hdr.hjilesize , respectively. The contents of each file is recorded in 
an element of the array of varying length structures, archive , together 
with other items describing the file. Every instance of hjnagic con- 
tains the constant 070707 (octal). The items h_dev through hjntime 
have meanings explained in stat(S). The length of the null-terminated 
pathname hjiame, including the null byte, is given by hjiamesize . 

The last record of the archive always contains the name TRAILER!!!. 
Special files, directories, and the trailer are recorded with hjilesize 
equal to zero. 

See Also 

cpio(C), find(C), stat(S) 
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Name 

default - Default program information directory. 



Description 

The files in the directory /etc/default contain the default information 
used by system commands such as backup(C) and remote(C). 
Default information is any information required by the command that 
is not explicitly given when the command is invoked. 

The directory may contain zero or more files. Each file corresponds to 
one or more commands. A command searches a file whenever it has 
been invoked without sufficient information. Each file contains zero 
or more entries which define the default information. Each entry has 
the form: 

keyword 

or 

keyword=value 

where keyword identifies the type of information available and value 
defines its value. Both keyword and value must consist of letters, 
digits, and punctuation. The exact spelling of a keyword and the 
appropriate values depend on the command and are described with the 
individual commands. 

Any line in a file beginning with a number sign (#) is considered a 
comment and is ignored. 



Files 

/etc/default/ archive 

/etc/default/backup 

/etc/default/boot 

/etc/default/ cron 

/etc/default/dumpdir 

/etc/default/ dumpsrv 

/etc/default/ filesy s 

/etc/default/format 

/etc/default/login 

/etc/defaultApd 

/etc/default/man 

/etc/default/mapchan 

/etc/default/micnet 

/etc/default/mkuser 

/etc/default/msdos 

/etc/default/passwd 
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/etc/default/restor 

/etc/default/su 

/etc/default/tar 

/etc/ def ault/usemouse 



See Also 

archive(F), backup(C), boot(HW), cron(C), dos(C), dumpdir(C), 
filesys(F), login(M), lpr(C), mapchan(M), mapchan(F), micnet (F), 
mkuser(ADM), pwadmin(ADM), remote(C), restore(C), su(C), 
sysadmin(ADM), tar(C) 



Note 

Not all commands use /etc/default files. Please refer to the manual 
page for a specific command to determine if /etc/default files are used, 
and what information is specified. 
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Name 

dir - Format of a directory. 



Syntax 

#include <sys/dir.h> 



Description 

A directory behaves exactly like an ordinary file, except that no user 
may write into a directory. The fact that a file is a directory is indi- 
cated by a bit in the flag word of its inode entry (see filesystem (F)). 
The structure of a directory is given in the include file 
/usr/include/ sys/dir.h. 

By convention, the first two entries in each directory are"dot" (.) and 
"dotdot" (..)• The first is an entry for the directory itself. The second 
is for the parent directory. The meaning of dotdot is modified for the 
root directory of the master file system; there is no parent, so dotdot 
has the same meaning as dot. 



See Also 

filesystem(F) 
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Name 

dump - Incremental dump tape format. 
Description 

The dump and restor commands are used to write and read incremen- 
tal dump magnetic tapes. 

The dump tape consists of a header record, some bit mask records, a 
group of records describing file system directories, a group of records 
describing file system files, and some records describing a second bit 
mask. 

The header record and the first record of each description have the for- 
mat described by the structure included by: 

#include <dumprestor.h> 

Fields in the dumprestor structure are described below. 

NTREC is the number of 512 byte blocks in a physical tape record. 
MLEN is the number of bits in a bit map word. MSIZ is the number of 
bit map words. 

The TS_ entries are used in the cjype field to indicate what sort of 
header this is. The types and their meanings are as follows: 

TS_TYPE Tape volume label. 

TSJNODE A file or directory follows. The c_dinode field is a 
copy of the disk inode and contains bits telling what 
sort of file this is. 

TS_BITS A bit mask follows. This bit mask has a one-bit for 
each inode that was dumped. 

TS_ADDR A subblock to a file (TSJNODE). See the description 
of c_count below. 

TS_END End of tape record. 

TS_CLRI A bit mask follows. This bit mask contains a one-bit 
for all inodes that were empty on the file system when 
dumped. 

MAGIC All header blocks have this number in cjnagic . 

CHECKSUM Header blocks checksum to this value. 
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The fields of the header structure are as follows: 
c_type The type of the header. 

The date the dump was taken. 
The date the file system was dumped from. 
The current volume number of the dump. 



c_date 
c_ddate 
c_volume 
ctapea 



The current block number of this record. This is count- 
ing 512 byte blocks. 

c_inumber The number of the inode being dumped if this is of 
type TSJNODE. 

c_magic This contains the value MAGIC above, truncated as 
needed. 



c_checksum This contains whatever value is needed to make the 
block sum to CHECKSUM. 



c_dinode This is a copy of the inode as it appears on the file sys- 
tem. 



c_count This is the count of characters following that describe 

the file. A character is zero if the block associated 
with that character was not present on the file system, 
otherwise the character is nonzero. If the block was 
not present on the file system no block was dumped 
and it is replaced as a hole in the file. If there is not 
sufficient space in this block to describe all of the 
blocks in a file, TS_ADDR blocks will be scattered 
through the file, each one picking up where the last 
left off. 



c_addr This is the array of characters that is used as described 

above. 



Each volume except the last ends with a tapemark (read as an end of 
file). The last volume ends with a TS_END block and then the tape- 
mark. 



The structure idates describes an entry of the file where dump history 
is kept. 



See Also 

dump(C), restor(C), filesystem(F) 
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Name 

filesys - Default information for mounting filesystems. 
Description 

I etc I default! filesys contains information for mounting filesystems in 
the following format: 

name=value [name=value] ... 

value may contain white spaces if quoted, and newlines may be 
escaped with a backslash. 

mnt (see mnt{C)) and sysadmin(ADM) use the information in the 
/etc/ default/ filesys when the system comes up multiuser. The follow- 
ing names are defined for /etc/default/ filesys: 

bdev Name of the block interface device. 

cdev Name of the character interface device. 

size Size in blocks. 

mountdir Directory on which the filesystem is mounted. 

desc A description of the filesystem. For example, 

"User filesystem." 

mountflags Any flags passed to the mount(ADM) command. 

fsckflags Any flags passed to the fsck(ADM) command. 

remount Whether or not to mount the filesystem when the 

system goes multiuser. Can be "yes", "no" or 
"prompt". If set to "prompt", you are prompted 
when it is time to mount the filesystem. 



See Also 

mount(ADM), mnt(C), sysadmin(ADM) 
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Name 

filesystem - Format of a system volume. 



Syntax 

#include <sys/filsys.h> 
#include <sys/types.h> 
#include <sys/param.h> 



Description 

Every file system storage volume (for example, a hard disk) has a 
common format for certain vital information. Every such volume is 
divided into a certain number of 1024 byte blocks. Block is unused 
and is available to contain a bootstrap program or other information. 

Block 1 is the super-block. The format of a super-block is described 
in /usr/include/sys/filesys.h. In that include file, SJsize is the 
address of the first data block after the i-list. The i-list starts just after 
the super-block in block 2; thus the i-list is s_isize-2 blocks long. 
SJsize is the first block not potentially available for allocation to a 
file. These numbers are used by the system to check for bad block 
numbers. If an "impossible" block number is allocated from the free 
list or is freed, a diagnostic is written on the console. Moreover, the 
free array is cleared so as to prevent further allocation from a presum- 
ably corrupted free list. 

The free list for each volume is maintained as follows. The sjree 
array contains, in s Jree [1], . . ., sjree [s_nfree-l], up to 99 numbers of 
free blocks. Sjree [0] is the block number of the head of a chain of 
blocks constituting the free list. The first short in each free-chain 
block is the number (up to 100) of free-block numbers listed in the 
next 100 longs of this chain member. The first of these 100 blocks is 
the link to the next member of the chain. To allocate a block: decre- 
ment sjifree, and the new block is sjree[s_nfree]. If the new block 
number is 0, there are no blocks left, so give an error. If sjifree 
becomes 0, read in the block named by the new block number, replace 
sjifree by its first word, and copy the block numbers in the next 100 
longs into the sjree array. To free a block, check if sjifree is 100; if 
so, copy sjifree and the sjree array into it, write it out, and set 
sjfree to 0. In any event set sjree [sjifree] to the freed block's 
number and increment sjifree . 

Sjfree is the total free blocks available in the file system. 

Sjtinode is the number of free i-numbers in the sjnode array. To 
allocate an inode: if sjinode is greater than 0, decrement it and 
return sjnode[sjinode]. If it was 0, read the i-list and place the 
numbers of all free inodes (up to 100) into the sjnode array, then try 
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again. To free an inode, provided sjiinode is less than 100, place its 
number into s_inode[s_ninode] and increment sjiinode. If sjiinode 
is already 100, do not bother to enter the freed inode into any table. 
This list of inodes only speeds up the allocation process. The informa- 
tion about whether the inode is really free is maintained in the inode 
itself. 

Sjinode is the total free inodes available in the file system. 

SJlock and sjlock are flags maintained in the core copy of the file 
system while it is mounted and their values on disk are immaterial. 
The value of s Jmod on disk is also immaterial, and is used as a flag to 
indicate that the super-block has changed and should be copied to the 
disk during the next periodic update of file system information. 

Sj-only is a read-only flag to indicate write-protection. 

Sjime is the last time the super-block of the file system was changed, 
and is a double precision representation of the number of seconds that 
have elapsed since 00:00 Jan. 1, 1970 (GMT). During a reboot, the 
sjime of the super-block for the root file system is used to set the 
system's idea of the time. 

I-numbers begin at 1, and the storage for inodes begins in block 2. 
Also, inodes are 64 bytes long, so 16 of them fit into a block. There- 
fore, inode i is located in block (/+31)/16, and begins 
64x((/+31) (mod 16)) bytes from its start. Inode 1 is reserved for 
future use. Inode 2 is reserved for the root directory of the file system, 
but no other i-number has a built-in meaning. Each inode represents 
one file. For the format of an inode and its flags, see inode (F). 



Files 

/usr/include/sy s/f ilsy s .h 
/usr/include/sys/stat.h 



See Also 

fsck(ADM), mkfs(ADM), inode(F) 
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Name 

fstab - File system mount and check commands. 



Description 

fstab is an ASCII text file containing information that is passed to the 
mount (ADM) and fsck (ADM) commands that are executed from 
/etc/rc. A typical /etc/fstab file might look like this: 

# device directory optional flags 

/dev/u /u fsckflags="-y -D" 

/dev/archive /archive mountflags="-r" fsckflags="-f" 

The first column lists the device to be mounted and the second column 
gives the mount point (directory) for the device. 

The third column lists any optional flags. Optional flags are: 

fsckflags - Flags that are passed to fsck. 

mountflags - Flags that are passed to mount. 

prompt - If set to "y", prompts whether or not to 

mount filesystem. Default is "n". 

Comment lines start with a number sign (#). 



See Also 

fsck(ADM), mount(ADM) 
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Name 

gettydefs - Speed and terminal settings used by getty. 



Description 

The /etc/gettydefs file contains information used by getty (M) to set up 
the speed and terminal settings for a line. It supplies information on 
what the login prompt should look like. It also supplies the speed to 
try next if the user indicates the current speed is not correct by typing 
a BREAK character. 



Each entry in /etc/gettydefs has the following format: 

label# initial-flags # final-flags # login-prompt #next-label [# 
login-program] 

Each entry must be followed by a carriage return and a blank line. 
The various fields can contain quoted characters of the form \b, \n, \c, 
etc., as well as \nnn, where nnn is the octal value of the desired char- 
acter. The various fields are: 



label Identifies the /etc/gettydefs entry to getty . This could 

be a letter or number. The label corresponds to the line 
mode field in /etc/ttys. Init passes the line mode as an 
argument to getty . 

initial-flags Sets the initial ioctl (S) settings if a terminal type is not 
specified to getty . The flags that getty understands are 
the same as the ones listed in tty(M). Normally only 
the speed flag is required in the initial- flags . Getty 
automatically sets the terminal to raw input mode and 
takes care of most of the other flags. The initial-flag 
settings remain in effect until getty executes login(M). 

final-flags Sets the same values as the initial-flags. These flags 
are set just prior to getty executing login-program . The 
speed flag is again required. The composite flag SANE 
is a composite flag that sets the following termio(M) 
parameters: 

modes set: 

CREAD BRKINT IGNPAR ISTRIP ICRNL IXON 
ISIG ICANON ECHO ECHOK OPOST ONLCR 



modes cle£treci" 

CLOCAL IGNBRK PARMRK INPCK INLCR IUCLC 
IXOFF XCASE ECHOE ECHONL NOFLSH OLCUC 
OCRNL ONOCR ONLRET OFILL OFDEL NLDLY 
CRDLY TABDLY BSDLY VTDLY FFDLY 
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The other two commonly specified final-flags are TAB3, 
so that tabs are sent to the terminal as spaces, and 
HUPCL, so that the line is hung up on the final close. 

login-prompt Contains login prompt message that greets users. 

Unlike the above fields where white space is ignored (a 
space, tab, or new-line), it is included in the login- 
prompt field. The '@' in the login-prompt field is 
expanded to the first line in /etc/systemid (unless the 
'@' is preceded by a 'V). Several character sequences 
are recognized, including: 
\n Linefeed 
V Carriage return 
\v Vertical tab 

\nnn (3 octal digits) Specify ASCII character 

\t Tab 

\f Form feed 

\b Backspace 

next-label Identifies the next entry in gettydefs for getty to try if 
the current one is not successful. Getty tries the next 
label if a user presses the BREAK key while attempting 
to log in to the system. Groups of entries, for example, 
for dial-up lines or for TTY lines, should form a closed 
set so that getty cycles back to the original entry if 
none of the entries is successful. For instance, 2400 
linked to 1200, which in turn is linked to 300, which 
finally is linked to 2400. 

login-program 

The name of the program that actually logs the user 
onto XENIX. The default program is /etc/login. If pre- 
ceded by the keyword AUTO, getty will not prompt for 
a username, but instead uses its first argument as the 
username and executes the login-program immediately. 

If getty is called without a second argument, then the first entry of 
/etc/gettydefs is used, thus making the first entry of /etc/gettydefs the 
default entry. The first entry is also used if getty can not find the 
specified label. If /etc/gettydefs itself is missing, there is one entry 
built into the command which will bring up a terminal at 300 baud. 

After modifying /etc/gettydefs, run it through getty with the check 
option to be sure there are no errors. 



Files 

/etc/gettydefs 
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stty(C), ioctl(S), getty(M), login(M) 
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Name 

group - Format of the group file. 
Description 

group contains the following information for each group: 

- Group name 

- Encrypted password (optional) 

- Numerical group ID 

- Comma-separated list of all users allowed in the group 

This is an ASCII file. The fields are separated by colons; each group is 
separated from the next by a newline. If the password field is null, no 
password is demanded. 

This file resides in directory /etc. Because of the encrypted pass- 
words, it can and does have general read permission and can be used, 
for example, to map numerical group IDs to names. 

Files 

/etc/group 

See Also 

newgrp(C), passwd(C), passwd(F) 
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Name 

inittab - Alternative login terminals file. 



Description 

telinit(ADM) reads inittab and converts it into a tty s (F)-format file. 
init(M) reads /etc/ttys to determine for which terminals logins are 
allowed. 

Each line in inittab has the form: 

id'.run-levels '.action :/etc/getty tty mode 

id A one- to four-character name that uniquely identifies this line. It 
is recommended that if tty is ttyxx that the id then be "jut". 

run- levels 

A list of digits ranging from to 6. This list specifies which telinit 
states are concerned with this line. If the run-levels list is empty, 
then it is assumed to be "0123456" (all states). 

action 

Whether or not logins are allowed on tty : 
off 

Logins are not allowed in any of the listed run-levels . 
respawn 

Logins are allowed only in the listed run-levels. 

ondemand 

Identical to "respawn". 

tty The filename of a character device special file. Only the filename 
is supplied; the path is assumed to be /dev. 

mode 

A single character supplied as an argument to the getty(M) pro- 
gram. It defines the line characteristics (such as the baud rate) for 
the terminal, and must match one of the names listed in 
/etc/gettydefs. 

Exactly one space must separate ttys from ...:/etc/getty and from 
mode. No other spaces or tabs are allowed. 
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Files 

/etc/inittab 

See Also 

disable(C), enable(C), init(M), getty(M), gettydefs(F), telinit(ADM), 
ttys(F) 



inittab is provided for users more familiar with the telinit approach to 
terminal administration, as opposed to the standard XENIX 
enable (C) I disable (C) approach. It is intended that a full integration of 
these two approaches will be provided in a future version of XENIX. 



Notes 
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Name 

inode - Format of an inode. 

Syntax 

Mnclude <sys/types.h> 
#include <sys/ino.h> 

Description 

An inode for a plain file or directory in a file system has the structure 
defined by <sys/ino.h>. For the meaning of the defined types off J 
and time J see types (F). 

Files 

/usr/include/sys/ino.h 

See Also 

stat(S), filesystem(F), types(F) 
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Name 

mapchan - Format of tty device mapping files. 



Description 

mapchan configures the mapping of information input and output of 
XENIX. 

Each unique channel map requires a multiple of 1024 bytes (a IK 
buffer) for mapping the input and output of characters. No buffers are 
required if no channels are mapped. If control sequences are speci- 
fied, an additional IK buffer is required. 

A method of sharing maps is implemented for channels that have the 
same map in place. Each additional, unique map allocates an addi- 
tional buffer. The maximum number of map buffers available on a 
system is configured in the kernel, and is adjustable via the link kit 
NEMAP parameter (see config (ADM) and configure (ADM)). 
Buffers of maps no longer in use are returned for use by other maps. 



Example of a Map File 

The internal character set used by XENIX is defined by the right 
column of the input map, and the first column of the output map in 
place on that line. The default internal character set is the 8-bit ISO 
8859/1 character set, which is also known as dpANS X3.4.2 and 
ISO/TC97/SC2. It supports the Latin alphabet and can represent most 
European languages. 

Any character value not given is assumed to be a straight mapping, 
only the differences are shown in the mapfile . The left hand columns 
must be unique. More than one occurrence of any entry is an error. 
Right hand column characters can appear more than once. This is 
"many to one" mapping. Nulls can be produced with compose 
sequences or as part of an output string. 

It is recommended that no mapping be enabled on the channel used to 
create or modify the mapping files. This prevents any confusion of the 
actual values being entered due to mapping. It is also recommended 
that numeric rather than character representations be used in most 
cases, as these are not likely to be subject to mapping. Use comments 
to identify the characters represented. Refer to the ascii(M) manual 
page and the hardware reference manual for the device being mapped 
for the values to assign. 
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# 

# sharp/pound/cross-hatch is the comment character 

# however, a quoted # ('#') is 0x23, not a comment 
# 

# beep, input, output, dead, compose and 

# control are special keywords and should appear as shown. 
# 



beep 


# sound the bell when errors occur 


input 




a b 




c d 




Hpfld n 






# n fnllnwpH bv n vipIHs r 


S t 


# p followed by s yields /. 


dead u 




v w 


# u followed by v yields w. 




it a lo uic njiiipuoc tjcy \vuiy uuc oiiuwcu^. 


V Z A 




BCD 


# x followed by B and C yields D. 


output 




ef 


# e is mapped to/. 


8 h i j 


# g is mapped to hij - one to many. 


k I m n o 


#kis mapped to Imno. 


control 


# The control sections must be last 


input 




E 1 


# The character E is followed by 1 more 




unmapped character 


output 




FG 2 


# The characters FG are followed by 2 



more unmapped characters 



All of the single letters above preceding the "control" section must 
be in one of these formats: 

56 # decimal 

045 # octal 

Oxfa # hexadecimal 

'b' # quoted char 

\076' # quoted octal 

'\x4a' # quoted hex 

All of the above formats are translated to single byte values. 

The control sections (which must be the last in the file) contain 
specifications of character sequences which should be passed through 
to or from the terminal device without going through the normal map- 
chan processing. These specifications consist of two parts: a fixed 



May 16, 1988 



Page 2 



MAPCHAN (F) 



MAPCHAN (F) 



sequence of one or more defined characters indicating the start of a 
no-map sequence, followed by a number of characters of which the 
actual values are unspecified. 

To illustrate this, consider a cursor-control sequence which should be 
passed directly to the terminal without being mapped. Such a 
sequence would typically begin with a fixed escape sequence instruct- 
ing the terminal to interpret the following two characters as a cursor 
position; the values of the following two characters are variable, and 
depend on the cursor position requested. Such a control sequence 
would be specified as: 

\E= 2 # Cursor control: escape = <x> <y> 

There are two subsections under control: the input section is used to 
filter data sent from the terminal to XENIX, and the output section is 
used to filter data sent from XENIX to the terminal. The two fields in 
each control sequence are separated by white space, that is the SPACE 
or TAB characters. Also the '#' (HASH) character introduces a com- 
ment, causing the remainder of the line to be ignored. Therefore, if 
any of these three characters are required in the specification itself, 
they should be entered using one of alternative means of entering 
characters, as follows: 

~x The character produced by the terminal on pressing the CONTROL 
and x keys together. 

\E or\e 

The ESCAPE character, octal 033. 

V Where c is one of b, f, 1, n, r or t, produces BACKSPACE , FORM 
FEED , LINE FEED , NEWLINE , CARRIAGE RETURN or TAB char- 
acters respectively. 

\0 Since the NULL character can not be represented, this sequence is 
stored as the character with octal value 0200, which behaves as a 
NULL on most tenninals. 

\in ov\nnn 

Specifies the octal value of the character directly. 

\ followed by any other character is interpreted as that character. 
This can be used to enter SPACE , TAB , or HASH characters. 



Diagnostics 

mapchan performs these error checks when processing the mapfile: 

More than one compose key. Characters mapped to more than one 
thing. Syntax errors in the byte values. Missing input or output key- 
words. Dead or compose keys also occurring in the input section. 



May 16, 1988 



Page 3 



MAPCHAN (F) 



MAPCHAN (F) 



Extra information on a line. Mapping a character to null. Starting an 
output control sequence with a character that is already mapped. 

If characters are displayed as the 7-bit value instead of the 8-bit value, 
use stty -a to verify that -istrip is set. Make sure input is mapping to 
the 8859 character set, output is mapping from the 8859 to the device 
display character set. dead and compose sequences are input map- 
ping and should be going to 8859. 



Files 

/etc/default/mapchan 
/usr/lib/mapchan/* 



See Also 

ascii(M), keyboard(HW), lp(C), lpadmin(ADM), mapchan(M), 
trchan(M), mapkey(M), parallel(HW), screen(HW), serial(HW), 
setkey(M), tty(M) 



Notes 

Some non-U.S. keyboards and display devices do not support charac- 
ters commonly used by XENIX command shells and the C program- 
ming language. Do not attempt to use such devices for system 
administration tasks. 

Not all terminals or printers can display all the characters that can be 
represented using this utility. Refer to the device's hardware manual 
for information on the capabilities of the peripheral device. 



Warnings 

Use of mapping files that specify a different "internal' ' character set 
per-channel, or a set other than the 8-bit ISO 8859 set supplied by 
default can cause strange side effects. It is especially important to 
retain the 7-bit ASCII portion of the character set (see ascii(M)). 
XENIX utilities and applications assume these values. Media tran- 
sported between machines with different internal code set mappings 
may not be portable as no mapping is performed on block devices, 
such as tape and floppy drives, trchan can be used to "translate" from 
one internal character set to another. 

Do not set ISTRIP (see stty(C)) on channels that have mapping that 
includes eight bit characters. 
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Name 

master - Master device information table. 



Description 

master contains device information used by config(ADM) to generate 
the configuration files. The file consists of 5 parts, each separated by 
a line with a dollar sign ($) in column 1 . 

- Part 1 contains device information. 

- Part 2 contains the line discipline table. 

- Part 3 contains names of devices that have aliases. 

- Part 4 contains tunable parameter information. 

- Part 5 contains the event devices table. 

Any line with an asterisk (*) in column 1 is treated as a comment. 



Part 1 

This part contains definitions for the system devices. Each line has 14 
fields with the fields delimited by tabs and/or blanks: 

Field 1: Device name (8 chars, maximum). 

Field 2: Number of interrupt vectors. 

Field 3: Device mask (octal). Each "on" bit indicates that 
the driver has the corresponding handler or struc- 
ture: 

002000 Process swtch( ) time routine. 

001000 streamtab structure. 

000400 tty structure. 

000200 Halt routine. 

000100 Initialization handler. 

000040 Clock time poll routine. 

000020 Open handler. 

000010 Close handler. 

000004 Read handler. 

000002 Write handler. 

000001 Ioctl handler. 
The clock time poll routine, if present in the driver, is called every 
clock tick in which the clock interrupted task-time processing. 

If the streamtab bit is on, the device is a stream module with an 
fmodsw entry, unless the character special bit is set in the type 
indicator (Field 4). If this is the case, the device is a stream end 
driver with a cdevsw entry. 
Field 4: Device type indicator (octal): 
000200 Not used 
000100 No qswtch on interrupt. 
000040 Not used. 
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000020 Required device. 
000010 Block device. 
000004 Character device. 
000002 Not used. 
000001 Not used. 
Field 5: Handler prefix (4 chars, maximum). Usually same 
as Field 1. The routines of dev.c should begin dev... 
The tty structure of dev.c should be named devjty. 
Field 6: Not used. 

Field 7: Major device number for block-type device. 
Field 8: Major device number for character-type device. 
Field 9: Maximum number of devices per controller. 
Field 10: The spl level (1 - 7) at which the device's interrupt 

routine should be called. 
Fields 11-14: Maximum of four interrupt vector addresses (octal). 

Each address is followed by a unique letter or a 

blank. 

Devices that are not interrupt-driven have an interrupt vector size of 
zero. Devices that generate interrupts but are not of the standard char- 
acter or block device mold, should be specified with a type (field 4) 
which has neither the block nor character bits set. 



Part 2 

This part contains definitions for the system line discipline. Each line 

has 9 fields. Each field is a maximum of 8 characters delimited by a 
blank if less than 8: 

Field 1: Device associated with this line. 

Field 2: Open routine. 

Field 3: Close routine. 

Field 4: Read routine. 

Field 5: Write routine. 

Field 6: Ioctl routine. 

Field 7: Receiver interrupt routine. 

Field 8: Transmitter interrupt routine. 

Field 9: Modem control interrupt routine. 



Part 3 

This part contains definitions for device aliases. Each line has 2 
fields: 

Field 1: Alias name of device (8 chars, maximum). 
Field 2: Reference name of device as given in part 1 (8 
chars, maximum). 
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Aliases may be used in place of actual device names when creating 
the config(ADM) description file. 



Part 4 

This part contains the names and default values for tunable parame- 
ters. Each line has 2 or 3 fields: 

Field 1: Parameter name to be used in the config(ADM) 
description file (20 chars, maximum). 

Field 2: Parameter name as it will appear in the resulting c.c 
file (20 chars, maximum). 

Field 3: Default parameter value (20 chars, maximum). 

If a parameter has no default value, an explicit specification for the 
parameter must be given in the description file. See config (ADM) for 
a list of the tunable parameters. 



Part 5 

This part contains device names and handler routines for all devices 
used to generate events. 

See Also 

config(ADM), configure(ADM) 
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Name 

mem, kmem - Memory image file. 



Description 

The mem file provides access to the computer's physical memory. 
All byte addresses in the file are interpreted as memory addresses. 
Thus, memory locations can be examined in the same way as indivi- 
dual bytes in a file. Note that accessing a nonexistent location causes 
an error. 

The kmem file is the same as mem except that it corresponds to ker- 
nel virtual memory rather than physical memory. 

In rare cases, the mem and kmem files may be used to write to 
memory and memory-mapped devices. Such patching is not intended 
for the naive user and may lead to a system crash if not conducted 
properly. Patching device registers is likely to lead to unexpected 
results if the device has read-only or write-only bits. 



Files 

/dev/mem 
/dev/kmem 
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Name 

micnet - The Micnet default commands file. 



Description 

The micnet file lists the system commands that may be executed 
through the remote command. The file is required for each system in 
a Micnet network. Whenever a remote command is received through 
the network, the Micnet programs search the micnet file for the sys- 
tem command specified with the remote command. If found, the com- 
mand is executed. Otherwise, the command is ignored and an error 
message is returned to the system which issued the remote command. 

The file may contain one or more lines. If all commands may be exe- 
cuted, only the line 

executeall 

is required in the file. Otherwise, the commands must be listed indivi- 
dually. A line that defines an individual command has the form: 

command=commandpath 

Command is the command name to be specified in a remote command. 
Commandpath is the full pathname of the command on the specified 
system. The equal sign (=) separates the command and commandpath. 
For example, the line: 

cat=/bin/cat 

defines the command name cat (used in the remote command) to refer 
to the system command cat in the /bin directory. 

When executeall is set, commands are sought in a series of default 
directories. Initially, the directories are /bin and /usr/bin. The 
default directories can be explicitly defined in the file by including a 
line of the form: 

execpath=P ATH=directory [:directory] . .. 
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The first part of the line, execpaih-P 'ATH= , is required. Each direc- 
tory must be a valid pathname. The colon is required to separate 
directories. For example, the line: 

execpath=PATH=/bin:/usr/bin:/usr/bobf/bin 

sets the default directories to /bin, /usr/bin, and /usr/bobf/bin. 

Files 

/etc/default/micnet 

See Also 

aliases(M), netutil(ADM), systemid(F), top(F) 
Notes 

The rep command cannot be executed from a remote system unless 
the micnet file contains either executeall , or the line 

rcp=/usr/bin/rcp 
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Name 

mnttab - Format of mounted file system table. 



Syntax 

#include <stdio.h> 
#include <mnttab.h> 



Description 

The /etc/mnttab file contains a table of devices mounted by the 
mount (ADM) command. 

Each table entry contains the pathname of the directory on which the 
device is mounted, the name of the device special file, the read/write 
permissions of the special file, and the date on which the device was 
mounted. 

The maximum number of entries in mnttab is based on the system 
parameter NMOUNT located in /usr/sys/conf/space.c, which defines 
the number of allowable mounted special files. 



See Also 

mount(ADM) 
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Name 

null - The null file. 



NULL (F) 



Description 

Data written on a null special file is discarded. 
Reads from a null special file always return bytes. 

Files 

/dev/null 
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Name 

passwd - The password file. 



Description 

Passwd contains the following information for each user: 
-Login name 
-Encrypted password 
-Numerical user ID 
-Numerical group ID 
-Comment 

-Initial working directory 
-Program to use as shell 

Refer to finger (C) for information in the required format of the com- 
ment field for finger (C) to display the information. Each user is 
separated from the next by a newline. If the password field is null, no 
password is demanded; if the shell field is null, sh(C) is used. 

This file resides in the directory /etc. Because the passwords are 
encrypted, the file has general read permission and can be used, for 
example, to map numerical user IDs to names. 

The encrypted password consists of 13 characters chosen from a 64- 
character alphabet (., /, 0-9, A-Z, a-z), except when the password is 
null, in which case the encrypted password is also null. Password 
aging is in effect for a particular user if his encrypted password in the 
password file is followed by a comma and a nonnull string of charac- 
ters from the above alphabet. (Such a string must be introduced by the 
super-user.) The first character of the age denotes the maximum 
number of weeks for which a password is valid. A user who attempts 
to log in after his password has expired will be forced to supply a new 
one. The next character denotes the minimum period in weeks which 
must expire before the password may be changed. The remaining char- 
acters define the week (counted from the beginning of 1970) when the 
password was last changed. (A null string is equivalent to zero.) The 
first and second characters must have numerical values in the range 
0-63, where the dot (.) is equal to and lowercase z is equal to 63. If 
the numerical value of both characters is 0, the user will be forced to 
change his password the next time he logs in. If the second character 
is greater than the first, only the super-user will be able to change the 
password. 
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Files 

/etc/passwd 

See Also 

login(M), passwd(C), a641(S), 
pwadmin(ADM). 



PASSWD (F) 



getpwent(S), group(F), 
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Name 

sccsfile - Format of an SCCS file. 



Description 

An SCCS file is an ASCII file. It consists of six logical parts: the 
checksum, the delta table (contains information about each delta), 
user names (contains login names and/or numerical group IDs of users 
who may add deltas), flags (contains definitions of internal keywords), 
comments (contains arbitrary descriptive information about the file), 
and the body (contains the actual text lines intermixed with control 
lines). Each logical part of an SCCS file is described in detail below. 

Throughout an SCCS file there are lines which begin with the ASCII 
SOH (start of heading) character (octal 001). This character is 
hereafter referred to as the control character and will be represented 
graphically as @. Any line described below which is not depicted as 
beginning with the control character is prevented from beginning with 
the control character. Entries of the form DDDDD represent a five 
digit string (a number between 00000 and 99999). 

Checksum 

The checksum is the first line of an SCCS file. The form of the line is: 
@hDDDDD 

The value of the checksum is the sum of all characters, except those of 
the first line. The @hR provides a magic number of (octal) 064001. 

Delta Table 

The delta table consists of a variable number of entries of the form: 
@s DDDDD/DDDDD/DDDDD 

@d <type> <SCCS ID> yr/mo/da hr:mi:se <pgmr> DDDDD DDDDD 
@i DDDDD ... 
@x DDDDD ... 
@g DDDDD ... 
@m <MR number> 



@c <comments> ... 
@e 
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The first line (@s) contains the number of lines 
inserted/deleted/unchanged respectively. The second line (@d) con- 
tains the type of the delta (currently, normal: D, and removed: R), the 
SCCS ID of the delta, the date and time of creation of the delta, the 
login name corresponding to the real user ID at the time the delta was 
created, and the serial numbers of the delta and its predecessor, 
respectively. 

The @i, @x, and @g lines contain the serial numbers of deltas 
included, excluded, and ignored, respectively. These lines are 
optional. 

The @m lines (optional) each contain one MR number associated with 
the delta; the @c lines contain comments associated with the delta. 

The @e line ends the delta table entry. 



User Names 

The list of login names and/or numerical group IDs of users who may 
add deltas to the file, separated by new-lines. The lines containing 
these login names and/or numerical group IDs are surrounded by the 
bracketing lines @u and @U. An empty list allows anyone to make a 
delta. 



Keywords used internally (see admin(CP) for more information on 
their use). Each flag line takes the form: 



@f t <type of program> 

@f v <program name> 
@fi 
@fb 

@f m <module name> 

@f f <floor> 

@f c <ceiling> 

@f d <default-sid> 

@fn 

@fj 

@f 1 <lock-releases> 

@f q <user defined> 



The t flag defines the replacement for the identification keyword. 
The v flag controls prompting for MR numbers in addition to com- 
ments; if the optional text is present it defines an MR number validity 



Flags 



@f <flag> 



<optional text> 



The following flags are defined: 
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checking program. The i flag controls the warning/error aspect of the 
' 'No id keywords' ' message. When the i flag is not present, this mes- 
sage is only a warning; when the i flag is present, this message will 
cause a "fatal" error (the file will not be gotten, or the delta will not 
be made). When the b flag is present the -b option may be used with 
the get command to cause a branch in the delta tree. The m flag 
defines the first choice for the replacement text of the sccsfile.F iden- 
tification keyword. The f flag defines the "floor" release; the release 
below which no deltas may be added. The c flag defines the "ceil- 
ing' ' release; the release above which no deltas may be added. The d 
flag defines the default SID to be used when none is specified on a get 
command. The n flag causes delta to insert a "null" delta (a delta 
that applies no changes) in those releases that are skipped when a 
delta is made in a new release (e.g., when delta 5.1 is made after delta 
2.7, releases 3 and 4 are skipped). The absence of the n flag causes 
skipped releases to be completely empty. The j flag causes get to 
allow concurrent edits of the same base SID. The 1 flag defines a list 
of releases that are locked against editing (get (CP) with the -e option). 
The q flag defines the replacement for the identification keyword. 



Comments 

Arbitrary text surrounded by the bracketing lines @t and @T. The 
comments section typically contains a description of the file's pur- 
pose. 

Body 

The body consists of text lines and control lines. Text lines don't 
begin with the control character, control lines do. There are three 
kinds of control lines: insert, delete , and end, as follows: 

@I DDDDD 
@D DDDDD 
@E DDDDD 

The digit string (DDDDD) is the serial number corresponding to the 
delta for the control line. 

See Also 

admin(CP), delta(CP), get(CP), prs(CP) 
XENIX Programmer's Guide 
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Name 

stat - Data returned by stat system call. 



Syntax 

#include <sys/stat.h> 



Description 

The sys/stat.h include file contains the definition for the structure 
returned by the stat andfstat functions. The structure is defined as: 

struct stat{ 

dev_t st_dev; /* 



ino_t st_ino; 

ushort sh_mode; 

short st_nlink; 

ushort st_uid; 

ushort st_gid; 

dev_t st_rdev; 



/* inode number */ 
/* file mode */ 
/*# of links */ 
/* owner uid */ 
/* owner gid */ 
/* 



}; 



off_t st_size; /* file size in bytes */ 

time_t st_atime; /* time of last access */ 

time_t st_mtime; /* time of last data modification */ 

time_t st_ctime; /* time of last file status 'change' */ 



Note that the st_atime , stjntime , and st_ctime values are measured in 
seconds since 00:00:00 (GMT) on January 1, 1970. 

The stjnode value is actually a combination of one or more of the fol- 



lowing file mode values: 




S 


JJFMT 


0170000 


/* type of file */ 


S 


IFDIR 


0040000 


/* directory */ 

/* character special */ 


S 


IFCHR 


0020000 


S 


JJFBLK 


0060000 


/* block special */ 
/* regular */ 


S 


TPREG 


0100000 


S 


IFTJFO 


0010000 


/* fifo */ 


S 


JJFNAM 


0050000 


/* name special entry */ 


S 


INSEM 


01 


/* semaphore */ 
/* shared memory */ 


S 


INSHD 


02 


S 


ISUID 


04000 


/* set user id on execution */ 
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S_IGUID 
S_ISVTX 
S_IREAD 
S_IWRITE 
S ffiXEC 



02000 /* set group id on execution */ 

01000 /* save swapped text even after use */ 

00400 /* read permission, owner */ 

00200 /* write permission, owner */ 

00100 /* execute/search permission, owner */ 



Files 

Aisr/include/sys/stat.h 



See Also 

stat(S) 
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Name 

systemid - The Micnet system identification file. 



Description 

The systemid file contains the machine and site names for a system in 
a Micnet network. A machine name identifies a system and distin- 
guishes it from other systems in the same network. A site name iden- 
tifies the network to which a system belongs and distinguishes the net- 
work from other networks in the same chain. 

The systemid file may contain a site name and up to four different 
machine names. The file has the form: 

[site-name] 
[machine-name 1] 
[machine-name2] 
[machine-name3] 
[machine-name4] 

The file must contain at least one machine name. The other machine 
names are optional, serving as alternate names for the same machine. 
The file must contain a site name if more than one machine name is 
given or if the network is connected to another through a uucp link. 
The site name, when given, must be on the first line. 

Each name can have up to eight letters and numbers but must always 
begin with a letter. There is never more than one name to a line. A 
line beginning with a pound sign (#) is considered a comment line and 
is ignored. 

The Micnet network requires one systemid file on each system in a 
network with each file containing a unique set of machine names. If 
the network is connected to another network through a uucp link, each 
file in the network must contain the same site name. 

The systemid file is used primarily during resolution of aliases. When 
aliases contain site and/or machine names, the name is compared with 
the names in the file and removed if there is a match. If there is no 
match, the alias (and associated message, file, or command) is passed 
on to the specified site or machine for further processing. 
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Files 

/etc/systemid 

See Also 

aliases(M), netutil(ADM), top(F) 



SYSTEMID (F) 



( 
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Name 

tar - archive format 



Description 

The command tar(C) dumps files to and extracts files from backup 
media or the hard disk. 

Each file is archived in contiguous blocks, the first block being occu- 
pied by a header, whose format is given below, and the subsequent 
blocks of the files occupying the following blocks. All headers and 
file data start on 512 byte block boundaries and any spare unused 
space is padded with garbage. The format of a header block is as fol- 
lows: 

#defineTBLOCK512 
#define NBLOCK 20 
#define NAMSIZ 100 
union hblock { 

char dummy [TBLOCK]; 
struct header { 

charname[NAMSIZ]; 

char mode[8]; 

char uid[8]; 

char gid[8]; 

char size[12]; 

char mtime[12]; 

char chksum[8]; 

char linkflag; 

char linkname[NAMSIZ]; 

char extno[4]; 

char extotal[4]; 

char efsize[12]; 
} dbuf ; 
} dblock; 

The name entry is the path name of the file when archived. If the path- 
name starts with a zero word, the entry is empty. It is at most 100 
bytes long and ends in a null byte. Mode, uid, gid, size, and time 
modified are the same as described under i-nodes (refer to 
filesystem (F)). The checksum entry has a value such that the sum of 
the words of the directory entry is zero. 

If the entry corresponds to a link, then linkname contains the path- 
name of the file to which this entry is linked and linkflag gives a count 
of the links. No data is put in the archive file. 

See Also 

filesystem(F), tar(C) 
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Name 



term - Terminal driving tables for nroff . 



Description 

nroff(CT) uses driving tables to customize its output for various types 
of output devices, such as printing terminals, special word-processing 
printers (such as Diablo, Qume, or NEC Spinwriter mechanisms), or 
special output filter programs. These driving tables are written as C 
programs, compiled, and installed in /usr/lib/term/tabwame, where 
name is the name for that terminal type as shown in term(CT). 

The structure of the tables is as follows. Sizes are in 240ths of an 
inch. 

#define INCH 240 

struct termtable tip ; { \* lp is the name of the term, *\ 



int bset; \* modify with new name, such as tnew *\ 
int breset; 
int Hor; 
int Vert; 
int Newline; 
int Char; 
int Em; 
int Halfline; 
int Adj; 
char *twinit; 
char *twrest; 
char *twnl; 
char *hlr; 
char *hlf; 
char *flr; 
char *bdon; 
char *bdoff; 
char *iton; 
char *itoff; 
char *ploton; 
char *plotoff; 
char *up; 
char *down; 
char *right; 
char *left; 

char *codetab[256-32]; 
char *zzz; 



}; 



The meanings of 



the various fields are as follows: 
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bset bits to set in termio.c_oflag see tty(M) and termio(M)). 

after output. 

breset bits to reset in termio.c_oflag before output. 

Hor horizontal resolution in fractions of an inch. 

Vert vertical resolution in fractions of an inch. 

Newline space moved by a newline (linefeed) character in frac- 
tions of an inch. 

Char quantum of character sizes, in fractions of an inch, (i.e., 
characters are multiples of Char units wide. See codetab 
below.) 

Em size of an em in fractions of an inch. 

Halfline space moved by a half-linefeed (or half-reverse-linefeed) 
character in fractions of an inch. 

Adj quantum of white space for margin adjustment in the 

absence of the -e option, in fractions of an inch, (i.e., 
white spaces are a multiple of Adj units wide) 

Note: if this is less than the size of the space character (in 
units of Char; see below for how the sizes of characters 
are defined), nroff will output fractional spaces using plot 
mode. Also, if the -e switch to nroff is used, Adj is set 
equal to Hor by nroff. 



twinit set of characters used to initialize the terminal in a mode 
suitable for nroff. 

twrest set of characters used to restore the terminal to normal 
mode. 

twnl set of characters used to move down one line. 

hlr set of characters used to move up one-half line. 

hlf set of characters used to move down one-half line. 

fir set of characters used to move up one line. 

bdon set of characters used to turn on hardware boldface mode, 



if any. Nroff assumes that boldface mode is reset 
automatically by the twnl string, because many letter- 
quality printers reset the boldface mode when they 
receive a carriage return; the twnl string should include 
whatever characters are necessary to reset the boldface 
mode. 
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bdoff set of characters used to turn off hardware boldface mode, 
if any. 

iton set of characters used to turn on hardware italics mode, if 

any. 

itoff set of characters used to turn off hardware italics mode, if 

any. 

ploton set of characters used to turn on hardware plot mode (for 
Diablo-type mechanisms), if any. 

plotoff set of characters used to turn off hardware plot mode (for 
Diablo-type mechanisms), if any. 

up set of characters used to move up one resolution unit 

(Vert) in plot mode, if any. 

down set of characters used to move down one resolution unit 
(Vert) in plot mode, if any. 

right set of characters used to move right one resolution unit 
(Hor) in plot mode, if any. 

left set of characters used to move left one resolution unit 

(Hor) in plot mode, if any. 

codetab Array of sequences to print individual characters. Order 
is nroffs internal ordering. See the file 
/usr/lib/term/tabuser.c for the exact order. 

zzz a zero terminator at the end. 

The codetab sequences each begin with a flag byte. The top bit indi- 
cates whether the sequence should be underlined in the .ul font. The 
rest of the byte is the width of the sequence in units of Char. 

The remainder of each codetab sequence is a sequence of characters 
to be output. Characters with the top bit off are output as given; char- 
acters with the top bit on indicate escape into plot mode. When such 
an escape character is encountered, nroff shifts into plot mode, emit- 
ting ploton, and skips to the next character if the escape character was 
'\200'. 

When in plot mode, characters with the top bit off are output as given. 
A character with the top bit on indicates a motion. The next bit indi- 
cates coordinate, with 1 being vertical and being horizontal. The 
next bit indicates direction, with 1 meaning up or left. The remaining 
five bits give the amount of the motion. An amount of zero causes exit 
from plot mode. 



May 16, 1988 



Page 3 



TERM (F) 



TERM (F) 



When plot mode is exited, either at the end of the string or via the 
amount-zero exit, plotoff 'is emitted followed by a blank. 

All quantities which are in units of fractions of an inch should be 
expressed as TNCH*num/denom, where num and denom are respec- 
tively the numerator and denominator of the fraction; that is, 1/48 of 
an inch would be written as "INCH/48". 

If any sequence of characters does not pertain to the output device, 
that sequence should be given as a null string. 

The XENIX Development System must be installed on the computer to 
create a new driving table. The source code for a generic output dev- 
ice is in the file /usr/lib/term/tabuser.c Copy this file and make the 
necessary modifications, including the name of the termtable struct. 
Refer to the hardware manual for the codes needed for the output dev- 
ice (terminal, printer, etc.). Name the file according to the convention 
explained in term(CT). The makefile, /usr/lib/term/ makefile, should 
be updated to include the source file to the new driving table. When 
the files are prepared, enter the command : 

make 

(See make(CP)). The source to the new driving table is linked with the 
object file mkterm.o, and the new driving table is created and installed in 
the proper directory. 



FILES 

/usrAib/term/tabname driving tables 
/usr/lib/term/tabuser.c generic source for driving tables 
/usr/lib/term/makefile makefile for creating driving tables 
/usrAib/term/mkterms.olinkable object file for creating driving tables 



SEE ALSO 

nroff(CT), term(CT). 



Notes 

The XENIX Development System must be installed on the computer 
to create new driving tables. 

Not all XENIX facilities support all of these options. 
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Name 

tenninfo - Format of compiled terminfo file. 



Description 

Compiled terminfo descriptions are placed under the directory 
/usr/lib/terminfo. In order to avoid a linear search of a huge XENIX 
system directory, a two-level scheme is used: 
/usr/lib/terminfo/ c/name where name is the name of the terminal, 
and c is the first character of name. Thus, act4 can be found in the file 
/usr/lib/terminfo/ a/act4. Synonyms for the same terminal are imple- 
mented by multiple links to the same compiled file. 

The format has been chosen so that it will be the same on all 
hardware. An 8- or more-bit byte is assumed, but no assumptions 
about byte ordering or sign extension are made. 

The compiled file is created with the tic(C) program, and read by the 
routine setupterm in terminfo(S). The file is divided into six parts: 
the header, terminal names, boolean flags, numbers, strings, and string 
table. 

The header section begins the file. This section contains six short 
integers in the format described below. These integers are (1) the 
magic number (octal 0432); (2) the size, in bytes, of the names sec- 
tion; (3) the number of bytes in the boolean section; (4) the number of 
short integers in the numbers section; (5) the number of offsets (short 
integers) in the strings section; (6) the size, in bytes, of the string 
table. 

Short integers are stored in two 8-bit bytes. The first byte contains the 
least significant 8 bits of the value, and the second byte contains the 
most significant 8 bits. (Thus, the value represented is 
256*second+first.) The value -1 is represented by 0377, 0377; other 
negative values are illegal. The -1 generally means that a capability is 
missing from this terminal. Note that this format corresponds to the 
hardware of the VAX and PDP-11. Machines in which this does not 
correspond to the hardware read the integers as two bytes and compute 
the result. 

The terminal names section comes next. It contains the first line of 
the terminfo description, listing the various names for the terminal, 
separated by the 'I' character. The section is terminated with an 
ASCII NUL character. 

The boolean flags have one byte for each flag. This byte is either or 
1, as the flag is present or absent. The capabilities are in the same 
order as the file <term.h>. 
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Between the boolean section and the number section, a null byte will 
be inserted, if necessary, to ensure that the number section begins on 
an even byte. All short integers are aligned on a short-word boundary. 

The numbers section is similar to the flags section. Each capability 
takes up two bytes, and is stored as a short integer. If the value 
represented is -1, the capability is taken to be missing. 

The strings section is also similar. Each capability is stored as a short 
integer, in the format above. A value of -1 means the capability is 
missing. Otherwise, the value is taken as an offset from the beginning 
of the string table. Special characters in "X or\c notation are stored in 
their interpreted form, not the printing representation. Padding infor- 
mation $<nn> and parameter information %x are stored intact in unin- 
terpreted form. 

The final section is the string table. It contains all the values of string 
capabilities referenced in the string section. Each string is null- 
terminated. 

Note that it is possible for setupterm to expect a different set of capa- 
bilities than are actually present in the file. Either the database may 
have been updated since setupterm was recompiled (resulting in extra 
unrecognized entries in the file) or the program may have been recom- 
piled more recently than the database was updated (resulting in miss- 
ing entries). The routine setupterm must be prepared for both possibil- 
ities; this is why the numbers and sizes are included. Also, new capa- 
bilities must always be added at the end of the lists of boolean, 
number, and string capabilities. 
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As an example, an octal dump of the description for the Microterm 
ACT 4 is included: 

microterm | act4 | microterm act iv, 

cr=~M, cudl=~J, ind="J, bel=~G, am, cubl=~H, 
ed=~_, el=~", clear=~L, cup=~T%pl%c%p2%c, 
cols#80, lines#24, cufl="X, cuul="Z, home=~], 
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Some limitations: the total size of a compiled description cannot 
exceed 4096 bytes; the name field cannot exceed 128 bytes. 

Files 

/usr/lib/terminfo/*/* compiled terminal capability data base 

See Also 

terminfo(M), terminfo(S), tic(C) 
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Name 

top, top.next - The Micnet topology files. 



Description 

These files contain the topology information for a Micnet network. 
The topology information describes how the individual systems in the 
network are connected, and what path a message must take from one 
system to reach another. Each file contains one or more lines of text. 
Each line of text defines a connection or a communication path. 

The top file defines connections between systems. Each line lists the 
machine names of the connected systems, the serial lines used to make 
the connection, and the speed (baud rate) of transmission between the 
systems. Each line has the following format: 

machine 1 ttyla machine2 tty2a speed 

machinel and machine2a are the machine names of the respective sys- 
tems (as given in the systemid files). The ttys are the device names 
(e.g., ttyla) of the connecting serial lines. The speed must be an 
acceptable baud rate (e.g., 1 10, 300, 19200). 

The top.next file contains information about how to reach a particular 
system from a given system. There may be several lines for each sys- 
tem in the network. Each line lists the machine name of a system, fol- 
lowed by the machine name of a system connected to it, followed by 
the machine names of all the systems that may be reached by going 
through the second system. Such a line has the form: 

machinel machine2 machine3 [machine4]... 

The machine names must be the names of the respective systems (as 
given by the first machine name in the systemid files). 

The top.next file must be present even if there are only two computers 
in the network. In such a case, the file must be empty. 

In the top and top.next files, any line beginning with a number sign 
(#) is considered a comment, and is ignored. 

Files 

/usr/lib/mail/top 
/usr/lib/mail/top.next 
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See Also 

aliases(M), netutil(ADM), systemid(F), top(F) 
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TTYS (F) 



77TS(F) 



Name 

ttys - Login terminals file. 



Description 

The /etc/ttys file contains a list of the device special files associated 
with possible login terminals, and defines which files are to be opened 
by the init(M) program on system start-up. 

The file contains one or more entries of the form 

state mode name 

The name must be the filename of a device special file. Only the 
filename may be supplied, the path is assumed to be /dev. If state is 
"1", the file is enabled for logins; if "0", the file is disabled. The 
mode is used as an argument to the getty (M) program. It defines the 
line speed and type of device associated with the terminal. A list of 
arguments is provided in getty (M). 

For example, the entry "lmtty02" means the serial line tty02 is to be 
opened for logging in at 9600 baud. 



Files 

/etc/ttys 



See Also 

disable(C), enable(C), getty(M), init(M), terminal(HW), terminals(M), 
tty(M) 



Notes 

The /etc/ttys file should only be edited when the system is in system 
maintenance mode. If it is edited when the system is in multi-user 
mode, the changes will not take effect until signal 2 is sent to init or 
an enable or disable command is given. (Enter the following com- 
mand as root to send signal 2 to init: kill -2 1.) Rebooting the system 
will also cause the changes to take effect. See the XENIX System 
Administrator' s Guide. 
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Name 

types - Primitive system data types. 



Syntax 

#include <sys/types.h> 



Description 

The data types defined in the include file <sys/types.h> are used in 
XENIX system code; some data of these types are accessible to user 
code. 

The form daddrj is used for disk addresses except in an inode on 
disk, see filesy stem (F). Times are encoded in seconds since 00:00:00 
GMT, January 1, 1970. The major and minor parts of a device code 
specify kind and unit number of a device and are installation- 
dependent. Offsets are measured in bytes from the beginning of a file. 
The label j variables are used to save the processor state while 
another process is running. 



See Also 

filesystem(F) 
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Name 



utmp, wtmp - Formats of utmp and wtmp entries. 



Syntax 



#include <sys/types.h> 
#include <utmp.h> 



Description 

These files, which hold user and accounting information for such com 
mands as who(C), write (C), and /c»g/n(M), have the following struc 
ture as defined by <utmp.h>: 



#define UTMP_FILE "/etc/utmp" 
#define WTMP_FILE "/etc/wtmp" 
#define ut_name ut_user 



struct utmp { 



char 


ut_user[8]; 


/* User login name */ 


char 


ut_id[4]; 


/* 


usually line # */ 


char 


ut_line[12]; 


/* 


device name (console, lnxx) */ 


short 


ut_pid; 


/* 


process id */ 


short 


ut_type; 


/* 


type of entry */ 


struct 


exit_status { 






short 


e_termination; 


/* 


Process termination status */ 


short 


e_exit; 


/* 


Process exit status */ 


} ut_exit; 




/* 


The exit status of a process 








marked as DEADJPROCESS. = 


time_t 


ut_time; 


/* 


time entry was made */ 



/* Definitions for utjype */ 



#define EMPTY 
#define RUN_LVL 

#define BOOTTTME 2 

#define OLD_TIME 3 

#define NEW_TIME 4 

#define INIT_PROCESS 5 

#define LOGIN_PROCESS 6 

#defme USER_PROCESS 7 
#define DEAD_PROCESS 

#define ACCOUNTING 9 

#define UTMAXTYPE ACCOUNTING /* Largest legal value of ut_type */ 



/* Process spawned by "init" */ 

/* A "getty" process waiting for login */ 

/* A user process */ 



/* Special strings or formats used in the "ut_line" field when */ 

/* accounting for something other than a process */ 

/* No string for the ut_line field can be more than 1 1 chars + */ 

/* a NULL in length */ 

#define RUNLVL_MSG "run-level %c" 

#define BOOT_MSG "system boot" 
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UTMP (F) 



#define OTIME_MSG 
#define NTIME_MSG 



"old time" 
"new time" 



Files 



/usr/include/utmp.h 

/etc/utmp 

/etc/wtmp 

See Also 

getut(S), login(C), who(C), write(C) 
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Permuted Index 



Commands, System Calls, Library Routines and File Formats 



This permuted index is derived from the "Name" description lines found on each 
reference manual page. Each index line shows the title of the entry to which the line 
refers, followed by the reference manual section letter where the page is found. 

To use the permuted index search the middle column for a key word or phrase. The right 
hand column contains the name and section letter of the manual page that documents 
the key word or phrase. The left column contains additional useful information about 
the command. Commands or routines are also listed in the context of the index line, 
followed by a colon (:). This denotes the "beginning" of the sentence. Notice that in 
many cases, the lines wrap, starting in the middle column and ending in the left column. 
A slash (/) indicates that the description line is truncated. 



coffconv: Convert 386 COFF files to XENIX format. . coffconv(M) 

Btol, ltol3: Converts between 3-byte integers and long/ .... 13tol(S) 

accepts a number of 5 12-byte blocks login(M) 

between long integer and base 64 ASCII. a641, 164a: Converts . . a641(S) 

Object Modules. 86rel: Intel 8086 Relocatable Format for ... 86rel(F) 

asx: XENIX 8086/186/286/386 Assembler. . . asx(CP) 

Format for Object Modules. 86rel: Intel 8086 Relocatable . . . 86rel(F) 

long integer and base 64 ASCII. a641, 164a: Converts between . . . a641(S) 

abort: Generates an IOT fault. . . abort(S) 

value, abs: Returns an integer absolute . abs(S) 

abs: Returns an integer absolute value abs(S) 

and/ /fabs, ceil, fmod: Performs absolute value, floor, ceiling . . . floor(S) 

integer, labs: Returns the absolute value of a long labs(DOS) 

blocks, accepts a number of 5 12-byte . . login(M) 

files, settime: Changes the access and modification dates of . settime(ADM) 

a file, touch: Updates access and modification times of . touch(C) 

utime: Sets file access and modification times. . . utime(S) 

of a file, access: Determines accessibility . access(S) 

dosls, dosrm, dosrmdir: Access DOS files dos(C) 

directory, chmod: Changes the access permissions of a file or . . chmod(C) 

a/ /nbwaitsem: Awaits and checks access to a resource governed by . waitsem(S) 

sdenter, sdleave: Synchronizes access to a shared data segment. . sdenter(S) 

sputl, sgetl: Accesses long integer data in a/ . . sputl(S) 

endutent, utmpname: Accesses utmp file entry getut(S) 

access: Determines accessibility of a file access(S) 

Synchronizes shared data access, sdgetv, sdwaitv: .... sdgetv(S) 

csplit: Splits files according to context csplit(C) 

rmuser: Removes a user account from the system rmuser(ADM) 

accton: Turns on accounting accton(ADM) 

acct: Format of per-process accounting file acct(F) 
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Searches for and prints process accounting files, acctcom: .... acctcom(ADM) 

imacct: Generate an IMAGEN accounting report imacct(C) 

Enables or disables process accounting, acct: acct(S) 

process accounting, acct: Enables or disables .... acct(S) 

accounting file, acct: Format of per-process . . . acct(F) 

process accounting files, acctcom: Searches for and prints . acctcom(ADM) 

accton: Turns on accounting. . . . accton(ADM) 

sin, cos, tan, asin, acos, atan, atan2: Performs/ . . . trig(S) 

Prints current SCCS file editing activity, sact: sact(CP) 

information about system activity, uptime: Displays .... uptime(C) 

debugger, adb: Invokes a general-purpose . . adb(CP) 

Copies bytes from a specific address, movedata: movedata(DOS) 

mkuser: Adds a login ID to the system. . . mkuser(ADM) 

nl: Adds line numbers to a file. . . . nl(C) 

lineprinters. lpinit: Adds, reconfigures and maintains . lpinit(ADM) 

swapadd: Adds swap area. ,. swapadd(S) 

putenv: Changes or adds value to environment. . . . putenv(S) 

SCCS files, admin: Creates and administers . . admin(CP) 

admin: Creates and administers SCCS files admin(CP) 

netutil: Administers the XENIX network. . netutil(ADM) 

uuinstall: Administers UUCP control files. . uuinstall(ADM) 

pwadmin: Performs password aging administration pwadmin(ADM) 

sysadmsh: Menu driven system administration utility sysadmsh(ADM) 

uadmin: administrative control uadmin(S) 

pwadmin: Performs password aging administration pwadmin(ADM) 

alarm: Sets a process' alarm clock alarm(S) 

clock, alarm: Sets a process' alarm . . . alarm(S) 

aliashash: Micnet alias hash table generator aliashash(ADM) 

table generator, aliashash: Micnet alias hash . . . aliashash(ADM) 

faliases: Micnet aliasing files aliases(M) 

brkctl: Allocates data in a far segment. . . brkctl(S) 

malloc, free, realloc, calloc: Allocates main memory malloc(S) 

brk: Changes data segment space allocation, sbrk, sbrk(S) 

file, inittab: Alternative login terminals . . . inittab(F) 

terminals/ telinit, mkinittab: Alternative method of turning . . telinit(ADM) 

Generates programs for lexical analysis, lex: lex(CP) 

document, style: Analyzes characteristics of a ... style(CT) 

link editor output. a.out: Format of assembler and . . a.out(F) 

ar: Archive file format ar(F) 

libraries, ar: Maintains archives and .... ar(CP) 

dc: Invokes an arbitrary precision calculator. . . dc(C) 

cpio: Format of cpio archive cpio(F) 

ar: Archive file format ar(F) 

tar: archive format tar(F) 

the names of files on a backup archive, dumpdir: Prints .... dumpdir(C) 

ar: Maintains archives and libraries ar(CP) 

tar: Archives files tar(C) 

cpio: Copies file archives in and out cpio(C) 

ranlib: Converts archives to random libraries. . . . ranlib(CP) 

swapadd: Adds swap area swapadd(S) 

varargs: variable argument list varargs(S) 
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output of a varargs argument list. /Prints formatted . . vprintf(S) 

getopt: Gets option letter from argument vector getopt(S) 

expr: Evaluates arguments as an expression. . . . expr(C) 

echo: Echoes arguments echo(C) 

ascii: Map of the ASCII character set ascii(M) 

character set. ascii: Map of the ASCII ascii(M) 

atof, atoi, atol: Converts ASCII to numbers atof(S) 

between long integer and base 64 ASCII. a641, 164a: Converts . . . a641(S) 

tzset: Converts date and time to ASCII, /gmtime, asctime, .... ctime(S) 

and/ ctime, localtime, gmtime, asctime, tzset: Converts date . . . ctime(S) 

Performs/ sin, cos, tan, asin, acos, atan, atan2: trig(S) 

commands, help: Asks for help about SCCS .... help(CP) 

time of day. asktime: Prompts for the correct . asktime(ADM) 

output, a.out: Format of assembler and link editor .... a.out(F) 

asx: XENIX 8086/186/286/386 Assembler asx(CP) 

masm: Invokes the XENIX assembler masm(CP) 

program, assert: Helps verify validity of . . assert(S) 

deassigns devices, assign, deassign: Assigns and . . assign(C) 

assign, deassign: Assigns and deassigns devices. . . assign(C) 

setbuf, setvbuf: Assigns buffering to a stream. . . setbuf(S) 

setkey: Assigns the function keys setkey(C) 

Assembler, asx: XENIX 8086/186/286/386 . . asx(CP) 

a later time, at, batch: Executes commands at . at(C) 

sin, cos, tan, asin, acos, atan, atan2: Performs/ trig(S) 

sin, cos, tan, asin, acos, atan, atan2: Performs trigonometric/ . . trig(S) 

to numbers, atof, atoi, atol: Converts ASCII . . atof(S) 

double-precision/ strtod, atof: Converts a string to a .... strtod(S) 

numbers, atof, atoi, atol: Converts ASCII to . . . atof(S) 

integer, strtol, atol, atoi: Converts string to strtol(S) 

integer, strtol, atol, atoi: Converts string to ... strtol(S) 

atof, atoi, atol: Converts ASCII to numbers. . atof(S) 

/Print file to printer attached to a serial console . . . consoleprint(ADM) 

lprint: Print to a printer attached to the user's terminal . . lprint(C) 

data segment, sdget, sdfree: Attaches and detaches a shared . . sdget(S) 

the system, autoboot: Automatically boots . . autoboot(ADM) 

schedule: Database for automated system backups .... schedule(ADM) 

autoboot: Automatically boots the system. . autoboot(ADM) 

resource/ waitsem, nbwaitsem: Awaits and checks access to a . . waitsem(S) 

processes, wait: Awaits completion of background . wait(C) 

a pattern in a file, awk: Searches for and processes . awk(C) 

wait: Awaits completion of background processes wait(C) 

Prints the names of files on a backup archive, dumpdir: .... dumpdir(C) 

sddate: Prints and sets backup dates sddate(C) 

/Default backup device information. . . . archive(F) 

format, backup: Incremental dump tape . . backup(F) 

file system backup, backup: Performs incremental . . backup(C) 

Performs incremental file system backup, backup: backup(C) 

Performs incremental file system backup, dump: dump(C) 

error-checking filesystem backup fsave: Interactive, .... fsave(ADM) 

sysadmin: Performs file system backups and restores files sysadmin(ADM) 

periodic semi-automated system backups fsphoto: Performs . . . fsphoto(ADM) 
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Database for automated system backups schedule: schedule(ADM) 

fixed disk for flaws and creates bad track table, badtrk: Scans . . badtrk(ADM) 

flaws and creates bad track/ badtrk: Scans fixed disk for ... badtrk(ADM) 

banner: Prints large letters banner(C) 

between long integer and base 64 ASCII. /164a: Converts . . a641(S) 

and sets the configuration data base, cmos: Displays cmos(HW) 

and sets the configuration data base, cmos: Displays ...... cmos(HW-86) 

names from pathnames, basename: Removes directory . . basename(C) 

Terminal capability data base, termcap: termcap(M) 

terminal capability data base, terminfo: terminfo(M) 

later time, at, batch: Executes commands at a . . at(C) 

be: Invokes a calculator bc(C) 

for diff. bdiff: Compares files too large . . bdiff(C) 

bdos: Invokes a DOS system call. . bdos(DOS) 

cb: Beautifies C programs cb(CP) 

jO, jl.jn, yO, yl, yn: Performs Bessel functions, bessel, .... bessel(S) 

Performs Bessel functions, bessel, jOJIJn, yO, yl, yn: . . . bessel(S) 

bfs: Scans big files. bfs(C) 

mail uudecode: decode a binary file for transmission via . . uuencode(C) 

mail uuencode: encode a binary file for transmission via . . uuencode(C) 

fixhdr: Changes executable binary file headers fixhdr(C) 

selected parts of executable binary files, hdr: Displays .... hdr(CP) 

fread, fwrite: Performs buffered binary input and output fread(S) 

bsearch: Performs a binary search bsearch(S) 

tfind, tdelete, twalk: Manages binary search trees, tsearch, . . . tsearch(S) 

Creates an instance of a binary semaphore, creatsem: . . . creatsem(S) 

Removes symbols and relocation bits, strip: strip(CP) 

shutdn: Flushes block I/O and halts the CPU. . . . shutdn(S) 

cmchk: Reports hard disk block size cmchk(C) 

df: Report number of free disk blocks df(C) 

Calculates checksum and counts blocks in a file, sum: sum(C) 

accepts a number of 5 12-byte blocks login(M) 

fdswap: Swaps default boot floppy drive fdswap(ADM) 

boot: XENIX boot program boot(HW) 

boot: XENIX boot program. . . . boot(HW) 

autoboot: Automatically boots the system autoboot(ADM) 

allocation, sbrk, brk: Changes data segment space . sbrk(S) 

segment, brkctl: Allocates data in a far . . . brkctl(S) 

search, bsearch: Performs a binary .... bsearch(S) 

output, fread, fwrite: Performs buffered binary input and .... fread(S) 

stdio: Performs standard buffered input and output stdio(S) 

setbuf, setvbuf: Assigns buffering to a stream setbuf(S) 

flushall: Flushes all output buffers flushall(DOS) 

a character to the console buffer, ungetch: Returns .... ungetch(DOS) 

mknod: Builds special files mknod(C) 

inp: Returns a byte inp(DOS) 

outp: Writes a byte to an output port outp(DOS) 

movedata: Copies bytes from a specific address. . . . movedata(DOS) 

swab: Swaps bytes swab(S) 

cc: Invokes the C compiler cc(CP) 

cflow: Generates C flow graph cflow(CP) 
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cpp: The C language preprocessor cpp(CP) 

lint: Checks C language usage and syntax. . . lint(CP) 

cxref: Generates C program cross-reference. . . . cxref(CP) 

cb: Beautifies C programs cb(CP) 

xref: Cross-references C programs xref(CP) 

xstr: Extracts strings from C programs xstr(CP) 

stack requirements for C programs. /Determines .... stackuse(CP) 

an error message file from C source, mkstr: Creates .... mkstr(CP) 

distance, hypot, cabs: Determines Euclidean . . . hypot(S) 

cal: Prints a calendar cal(C) 

blocks in a file, sum: Calculates checksum and counts . sum(C) 

be: Invokes a calculator bc(C) 

Invokes an arbitrary precision calculator, dc: dc(C) 

cal: Prints a calendar cal(C) 

service, calendar: Invokes a reminder . . . calendar(C) 

bdos: Invokes a DOS system call bdos(DOS) 

intdos: Invokes a DOS system call intdos(DOS) 

intdosx: Invokes a DOS system call intdosx(DOS) 

exit: Terminates the calling process exit(DOS) 

malloc, free, realloc, calloc: Allocates main memory. . . malloc(S) 

cu: Calls another XENIX system. . . cu(C) 

Data returned by stat system call, stat: stat(F) 

lineprinter. lp, lpr, cancel: Send/cancel requests to . . lp(C) 

termcap: Terminal capability data base termcap(M) 

terminfo: terminal capability data base terrninfo(M) 

descriptions into terminfo/ capinfo: convert termcap .... capinfo(C) 

files, cat: Concatenates and displays . . cat(C) 

catimp: Convert C/A/T files to imPRESS format. . . catimp(CT) 

Generate troff width files and catab file, charmap: charmap(CT) 

imPRESS format, catimp: Convert C/A/T files to . . catimp(CT) 

cb: Beautifies C programs cb(CP) 

cc: Invokes the C compiler. . . . cc(CP) 

cd: Changes working directory. . . cd(C) 

commentary of an SCCS delta, ede: Changes the delta cdc(CP) 

value, floor,/ floor, fabs, ceil, fmod: Performs absolute . . . floor(S) 

/Performs absolute value, floor, ceiling and remainder functions. . floor(S) 

cflow: Generates C flow graph. . . cflow(CP) 

cgets: Gets a string cgets(DOS) 

delta: Makes a delta (change) to an SCCS file delta(CP) 

allocation, sbrk, brk: Changes data segment space . . . sbrk(S) 

headers, fixhdr: Changes executable binary file . . fixhdr(C) 

chgrp: Changes group ID chgrp(C) 

passwd: Changes login password passwd(C) 

chmod: Changes mode of a file chmod(S) 

environment, putenv: Changes or adds value to .... putenv(S) 

chown: Changes owner ID chown(C) 

nice: Changes priority of a process. . . nice(S) 

command, chroot: Changes root directory for .... chroot(ADM) 

modification dates of/ settime: Changes the access and settime(ADM) 

of a file or directory, chmod: Changes the access permissions . chmod(C) 

an SCCS delta, ede: Changes the delta commentary of . cdc(CP) 
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file, newform: Changes the format of a text . . . newform(C) 

file, chown: Changes the owner and group of a . chown(S) 

chroot: Changes the root directory. . . . chroot(S) 

chsize: Changes the size of a file chsize(S) 

chdir: Changes the working directory. . . chdir(S) 

password file, chsh: changes user login shell in .... chsh(ADM) 

cd: Changes working directory. . . . cd(C) 

stream, ungetc: Pushes character back into input .... ungetc(S) 

eqnchar: Contains special character definitions for eqn. . . . eqnchar(CT) 

isatty: Checks for a character device isatty(DOS) 

ioctl: Controls character devices ioctl(S) 

fgetc, fgetchar. Gets a character from a stream fgetc(DOS) 

getch: Gets a character getch(DOS) 

getche: Gets and echoes a character getche(DOS) 

getc, getchar, fgetc, getw: Gets character or word from a stream. . getc(S) 

/putchar, fputc, putw: Puts a character or word on a stream. . . putc(S) 

ascii: Map of the ASCII character set ascii(M) 

trchan: Translate character sets trchan(M) 

fputc, fputchar: Write a character to a stream fputc(DOS) 

ungetch: Returns a character to the console buffer. . . ungetch(DOS) 

putch: Writes a character to the console putch(DOS) 

style: Analyzes characteristics of a document. . . style(CT) 

Displays/changes hard disk characteristics, dparam: dparam(ADM) 

strrev: Reverses the order of characters in a string. strrev(DOS) 

charater. strset: Sets all characters in a string to one . . . strset(DOS) 

ltoa: Converts long integers to characters ltoa(DOS) 

strlwr: Converts uppercase characters to lowercase strlwr(DOS) 

strupr: Converts lowercase characters to uppercase strupr(DOS) 

tr: Translates characters tr(C) 

ultoa: Converts numbers to characters ultoa(DOS) 

wc: Counts lines, words and characters wc(C) 

tolower, toascii: Translates characters, conv, toupper, .... conv(S) 

toascii: Classifies or converts characters, /tolower, toupper, . . ctype(S) 

characters in a string to one charater. strset: Sets all strset(DOS) 

files and catab file, charmap: Generate troff width . . charmap(CT) 

directory, chdir: Changes the working . . . chdir(S) 

fstab: File system mount and check commands fstab(F) 

permissions file uucheck: check the uucp directories and . . uucheck(ADM) 

constant-width text for/ cw, checkcw, cwcheck: Prepares . . . cw(CT) 

mathematical text/ eqn, neqn, checkeq, eqncheck: Formats . . . eqn(CT) 

processed by fsck. checklist: List of file systems . . . checklist(F) 

of MM macros, checkmm, mmcheck: Checks usage checkmm(CT) 

waitsem, nbwaitsem: Awaits and checks access to a resource/ . . . waitsem(S) 

fsck: Checks and repairs file systems. . fsck(ADM) 

syntax, lint: Checks C language usage and . . lint(CP) 

isatty: Checks for a character device. . . isatty(DOS) 

grpcheck: Checks group file grpcheck(C) 

diction: Checks language usage diction(CT) 

pwcheck: Checks password file pwcheck(C) 

keystroke, kbhit: Checks the console for a .... kbhit(DOS) 

to be read, rdchk: Checks to see if there is data . . . rdchk(S) 
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checkmm, mmcheck: Checks usage of MM macros. . . checkmm(CT) 

file, sum: Calculates checksum and counts blocks in a . sum(C) 

chgrp: Changes group ID chgrp(C) 

times: Gets process and child process times times(S) 

terminate, wait: Waits for a child process to stop or wait(S) 

chmod: Changes mode of a file. . . chmod(S) 

permissions of a file or/ chmod: Changes the access . . . chmod(C) 

chown: Changes owner ID. ... chown(C) 

group of a file, chown: Changes the owner and . . chown(S) 

for command, chroot: Changes root directory . . chroot(ADM) 

directory, chroot: Changes the root .... chroot(S) 

in password file, chsh: changes user login shell . . chsh(ADM) 

file, chsize: Changes the size of a ... chsize(S) 

tolower, toupper, toascii: Classifies or converts/ /isascii, . . ctype(S) 

uuclean: uucp spool directory clean-up uuclean(ADM) 

clear: Clears a terminal screen. . . clear(C) 

stream status, ferror, feof, clearerr, fileno: Determines . . . ferror(S) 

clear: Clears a terminal screen clear(C) 

clri: Clears inode clri(ADM) 

a shell command interpreter with C-like syntax, csh: Invokes . . . csh(C) 

alarm: Sets a process' alarm clock alarm(S) 

clock: Reports CPU time used. . . clock(S) 

(time of day) clock, clock: The system real-time . . . clock(F) 

system real-time (time of day) clock, clock: The clock(F) 

system real-time (time of day) clock, setclock: Sets the .... setclock(ADM) 

operations, closedir: Performs directory . . . directory(S) 

close: Closes a file descriptor close(S) 

fclose, fflush: Closes or flushes a stream fclose(S) 

shuts down the/ haltsys, reboot: Closes out the file systems and . . haltsys(ADM) 

fclose, fcloseall: Closes streams fclose(DOS) 

clri: Clears inode clri(ADM) 

size, cmchk: Reports hard disk block . . cmchk(C) 

configuration data base, cmos: Displays and sets the . . . cmos(HW) 

cmp: Compares two files cmp(C) 

coffconv: Convert 386 COFF files to XENIX format. . . coffconv(M) 

col: Filters reverse linefeeds. . . . col(CT) 

screen: tty [01 -«], color, monochrome, ega, screen(HW) 

setcolor: Set screen color setcolor(C) 

lc: Lists directory contents in columns lc(C) 

comb: Combines SCCS deltas. . . comb(CP) 

comb: Combines SCCS deltas comb(CP) 

common to two sorted files, comm: Selects or rejects lines . . comm(C) 

nice: Runs a command at a different priority. . . nice(C) 

segread: command description segread(DOS) 

env: Sets environment for command execution env(C) 

quits, nohup: Runs a command immune to hangups and . nohup(C) 

rsh: Invokes a restricted shell (command interpreter) rsh(C) 

sh: Invokes the shell command interpreter sh(C) 

syntax, csh: Invokes a shell command interpreter with C-like . csh(C) 

uux: Executes command on remote XENIX. . . . uux(C) 

getopt: Parses command options getopt(C) 
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system: Executes a shell command system(S) 

time: Times a command time(CP) 

Changes root directory for command, enroot: chroot(ADM) 

at, batch: Executes commands at a later time at(C) 

cron: Executes commands at specified times. . . . cron(C) 

micnet: The Micnet default commands file micnet(F) 

help: Asks for help about SCCS commands help(CP) 

intro: Introduces XENIX commands Intro(C) 

system, remote: Executes commands on a remote XENIX . . remote(C) 

xargs: Constructs and executes commands xargs(C) 

File system mount and check commands, fstab: fstab(F) 

Introduces text processing commands, intro: Intro(CT) 

XENIX Development System commands, intro: Introduces . . . Intro(CP) 

ede: Changes the delta commentary of an SCCS delta. . . cdc(CP) 

comm: Selects or rejects lines common to two sorted files. . . . comm(C) 

/the status of inter-process communication facilities ipcs(ADM) 

ftok: Standard interprocess communication package stdipc(S) 

dircmp: Compares directories dircmp(C) 

sdiff: Compares files side-by-side. . . . sdiff(C) 

diff. bdiff: Compares files too large for ... bdiff(C) 

diskcp, diskemp: Copies or compares floppy disks diskcp(C) 

difB: Compares three files diff3(C) 

cmp: Compares two files cmp(C) 

diff: Compares two text files diff(C) 

file, sccsdiff: Compares two versions of an SCCS sccsdiff(CP) 

regexp: Regular expression compile and match routines. . . . regexp(S) 

terminfo: Format of compiled terminfo file terminfo(F) 

cc: Invokes the C compiler cc(CP) 

tic: Terminfo compiler tic(C) 

yacc: Invokes a compiler-compiler yacc(CP) 

expressions, regex, regemp: Compiles and executes regular . . regex(S) 

regemp: Compiles regular expressions. . . regcmp(CP) 

erf, erfc: Error function and complementary error function. . . erf(S) 

processes, wait: Awaits completion of background .... wait(C) 

storage, compress: Compress data for ... compress(C) 

compress: Compress data for storage compress(C) 

pack, peat, unpack: Compresses and expands files. . . pack(C) 

scsi: Small computer systems interface. . . . scsi(HW) 

cat: Concatenates and displays files. . . cat(C) 

conditions, test: Tests test(C) 

system, config: Configures a XENIX . . . config(ADM) 

cmos: Displays and sets the configuration data base cmos(HW) 

hwconfig: Read the configuration information hwconfig(ADM) 

/mapscrn, mapstr, convkey: Configure monitor screen/ .... mapkey(M) 

mapchan: Configure tty device mapping. . . mapchan(M) 

config: Configures a XENIX system. . . . config(ADM) 

spooling system, lpadmin: Configures the lineprinter .... lpadmin(ADM) 

an out-going terminal line connection, dial: Establishes . . . dial(S) 

Returns a character to the console buffer, ungetch: .... ungetch(DOS) 

cputs: Puts a string to the console cputs(DOS) 

console: System console device. console(M) 
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kbhit: Checks the console for a keystroke kbhit(DOS) 

cscanf: Converts and formats console input cscanf(DOS) 

messages: Description of system console messages messages(M) 

putch: Writes a character to the console putch(DOS) 

console: System console device. . console(M) 

to printer attached to a serial console /Print file consoleprint(ADM) 

printer attached to a serial/ consoleprint: Print file to .... consoleprint(ADM) 

cw, checkcw, cwcheck: Prepares constant-width text for troff. . . . cw(CT) 

mkfs: Constructs a file system mkfs(ADM) 

commands, xargs: Constructs and executes xargs(C) 

nroff/troff, tbl, and eqn constructs, deroff: Removes . . . deroff(CT) 

debugging on uutry: try to contact remote system with . . . uutry(ADM) 

definitions for eqn. eqnchar: Contains special character .... eqnchar(CT) 

lc: Lists directory contents in columns lc(C) 

Is: Gives information about contents of directories ls(C) 

1: Lists information about contents of directory 1(C) 

Splits files according to context, csplit: csplit(C) 

UUCP control files, uuinstall: Administers uuinstall(ADM) 

init, inir: Process control initialization init(M) 

msgctl: Provides message control operations msgctl(S) 

uadmin: administrative control. uadmin(S) 

ioctl: Controls character devices. . . . ioctl(S) 

fcntl: Controls open files fcntl(S) 

semctl: Controls semaphore operations. . . semctl(S) 

operations, shmctl: Controls shared memory .... shmcfl(S) 

uucp status inquiry and job control, uustat: uustat(C) 

Translates characters, conv, toupper, tolower, toascii: . . conv(S) 

term: Conventional names. ...... term(CT) 

fcvt, gcvt: Performs output conversions, ecvt, ecvt(S) 

format, coffconv: Convert 386 COFF files to XENIX coffconv(M) 

and human-readable/ deco, enco: Convert between imPRESS format deco(CT) 

format, catimp: Convert C/A/T files to imPRESS . catimp(CT) 

format, dviimp: Convert DVI files to imPRESS . . dviimp(CT) 

into termirifo/ capinfo: convert termcap descriptions . . . capinfo(C) 

double-precision/ strtod, atof: Converts a string to a strtod(S) 

dd: Converts and copies a file dd(C) 

input, cscanf: Converts and formats console . . cscanf(DOS) 

scanf, fscanf, sscanf: Converts and formats input. . . . scanf(S) 

libraries, ranlib: Converts archives to random . . . ranlib(CP) 

atof, atoi, atol: Converts ASCII to numbers. . . . atof(S) 

and long/ 13tol, ltol3: Converts between 3-byte integers . 13tol(S) 

and base 64 ASCII. a641, 164a: Converts between long integer . . a641(S) 

toupper, toascii: Classifies or converts characters, /tolower, . . ctype(S) 

/gmtime, asctime, tzset: Converts date and time to ASCII. . ctime(S) 

characters, ltoa: Converts long integers to .... ltoa(DOS) 

uppercase, strupr: Converts lowercase characters to . strupr(DOS) 

ultoa: Converts numbers to characters. . ultoa(DOS) 

itoa: Converts numbers to integers. . . itoa(DOS) 

standard FORTRAN, ratfor: Converts Rational FORTRAN into ratfor(CP) 

strtol, atol, atoi: Converts string to integer strtol(S) 

format, iprint: Converts text files to DVI .... iprint(C) 
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units: Converts units units(C) 

lowercase, strlwr: Converts uppercase characters to . strlwr(DOS) 

screen/ mapkey, mapscrn, mapstr, convkey: Configure monitor . . . mapkey(M) 

dd: Converts and copies a file dd(C) 

address, movedata: Copies bytes from a specific . . . movedata(DOS) 

cpio: Copies file archives in and out. . . cpio(C) 

systems, rep: Copies files across XENIX .... rcp(C) 

cp: Copies files cp(C) 

copy: Copies groups of files copy(C) 

diskcp, diskemp: Copies or compares floppy disks. . diskcp(C) 

copy: Copies groups of files. . . . copy(C) 

Public XENIX-to-XENIX file copy. uuto,uupick: uuto(C) 

core: Format of core image file. . . core(F) 

core: Format of core image file core(F) 

asktime: Prompts for the correct time of day asktime(ADM) 

explain: Corrects language usage explain(CT) 

atan2: Performs/ sin, cos, tan, asin, acos, atan, .... trig(S) 

functions, sinh, cosh, tanh: Performs hyperbolic . . sinh(S) 

sum: Calculates checksum and counts blocks in a file sum(C) 

characters, wc: Counts lines, words and wc(C) 

cp: Copies files cp(C) 

cpio: Format of cpio archive cpio(F) 

and out. cpio: Copies file archives in ... cpio(C) 

cpio: Format of cpio archive. . . . cpio(F) 

preprocessor, epp: The C language cpp(CP) 

cprintf: Formats output cprintf(DOS) 

clock: Reports CPU time used clock(S) 

Flushes block I/O and halts the CPU. shutdn: shutdn(S) 

console, cputs: Puts a string to the .... cputs(DOS) 

rewrites an existing one. creat: Creates a new file or .... creat(S) 

file, tmpnam, tempnam: Creates a name for a temporary . . tmpnam(S) 

mkdir: Creates a new directory mkdir(DOS) 

an existing one. creat: Creates a new file or rewrites . . . creat(S) 

fork: Creates a new process fork(S) 

spawnl, spawnvp: Creates a new process spawn(DOS) 

ctags: Creates a tags file ctags(CP) 

tee: Creates a tee in a pipe tee(C) 

tmpfile: Creates a temporary file tmpfile(S) 

from C source, mkstr: Creates an error message file ... mkstr(CP) 

profile, profil: Creates an execution time .... profil(S) 

semaphore, creatsem: Creates an instance of a binary . . creatsem(S) 

pipe: Creates an interprocess pipe. . . . pipe(S) 

files, admin: Creates and administers SCCS . . admin(CP) 

/Scans fixed disk for flaws and creates bad track table badtrk(ADM) 

umask: Sets and gets file creation mask umask(S) 

a binary semaphore, creatsem: Creates an instance of . creatsem(S) 

listing, cref: Makes a cross-reference . . cref(CP) 

specified times, cron: Executes commands at ... cron(C) 

intro: Introduction to DOS cross development functions. . . . intro(DOS) 

dosld: XENIX to MS-DOS cross linker dosld(CP) 

cxref: Generates C program cross-reference cxref(CP) 
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cref: Makes a cross-reference listing cref(CP) 

xref: Cross-references C programs. . . xref(CP) 

console input, cscanf: Converts and formats . . . cscanf(DOS) 

interpreter with C-like syntax, csh: Invokes a shell command . . csh(C) 

to context, csplit: Splits files according . . . csplit(C) 

terminal ct: spawn getty to a remote . . . ct(C) 

ctags: Creates a tags file ctags(CP) 

for a terminal, ctermid: Generates a filename . . ctermid(S) 

asctime, tzset: Converts date/ ctime, localtime, gmtime, .... ctime(S) 

islower, isdigit, isxdigit,/ ctype, isalpha, isupper, ctype(S) 

cu: Calls another XENIX system. . cu(C) 

pointer, tell: Gets the current position of the file .... tell(DOS) 

activity, sact: Prints current SCCS file editing .... sact(CP) 

the slot in the utmp file of the current user, ttyslot: Finds .... ttyslot(S) 

getcwd: Get the pathname of current working directory getcwd(S) 

uname: Prints the name of the current XENIX system uname(C) 

uname: Gets name of current XENIX system uname(S) 

cursor functions, curses: Performs screen and . . . curses(S) 

curses: Performs screen and cursor functions curses(S) 

spline: Interpolates smooth curve spline(CP) 

the user, cuserid: Gets the login name of . . cuserid(S) 

each line of a file, cut: Cuts out selected fields of . . cut(CT) 

line of a file, cut: Cuts out selected fields of each . . cut(CT) 

constant-width text for troff. cw,checkcw, cwcheck: Prepares . cw(CT) 

text for troff. cw, checkcw, cwcheck: Prepares constant-width . cw(CT) 

cross-reference, cxref: Generates C program . . . cxref(CP) 

daemon.mn: Micnet mailer daemon daemon.mn(M) 

daemon.mn: Micnet mailer daemon. daemon.mn(M) 

sdwaitv: Synchronizes shared data access, sdgetv, sdgetv(S) 

termcap: Terminal capability data base termcap(M) 

terminfo: terminal capability data base terminfo(M) 

and sets the configuration data base, cmos: Displays .... cmos(HW) 

compress: Compress data for storage compress(C) 

brkctl: Allocates data in a far segment brkctl(S) 

/sgetl: Accesses long integer data in a machine-independent. . . sputl(S) 

plock: Lock process, text, or data in memory plock(S) 

prof: Displays profile data prof(CP) 

execseg: makes a data region executable execseg(S) 

call, stat: Data returned by stat system . . . stat(F) 

sbrk, brk: Changes data segment space allocation. . . sbrk(S) 

Synchronizes access to a shared data segment, sdenter, sdleave: . . sdenter(S) 

Attaches and detaches a shared data segment, sdget, sdfree: . . . sdget(S) 

rdchk: Checks to see if there is data to be read rdchk(S) 

types: Primitive system data types types(F) 

backups schedule: Database for automated system . . schedule(ADM) 

firstkey, nextkey: Performs database functions, /delete, . . . dbm(S) 

terminfo: terminal description database terminfo(S) 

tput: Queries the terminfo database tput(C) 

/gmtime, asctime, tzset: Converts date and time to ASCII ctime(S) 

date: Prints and sets the date date(C) 

date: Prints and sets the date. . . . date(C) 
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time, ftime: Gets time and date time(S) 

the access and modification dates of files. /Changes ..... settime(ADM) 

sddate: Prints and sets backup dates sddate(C) 

The system real-time (time of day) clock, clock: clock(F) 

the system real-time (time of day) clock, setclock: Sets .... setclock(ADM) 

Prompts for the correct time of day. asktime: asktime(ADM) 

firstkey, nextkey: Performs/ dbminit, fetch, store, delete, . . . dbm(S) 

precision calculator, dc: Invokes an arbitrary dc(C) 

dd: Converts and copies a file. . . dd(C) 

devices, assign, deassign: Assigns and deassigns . assign(C) 

assign, deassign: Assigns and deassigns devices assign(C) 

adb: Invokes a general-purpose debugger adb(CP) 

fsdb: File system debugger fsdb(ADM) 

sdb: Invokes symbolic debugger sdb(CP) 

to contact remote system with debugging on uutry: try uutry(ADM) 

imPRESS format and/ deco, enco: Convert between . . . deco(CT) 

transmission via mail uudecode: decode a binary file for uuencode(C) 

fdswap: Swaps default boot floppy drive fdswap(ADM) 

micnet: The Micnet default commands file micnet(F) 

information directory, default: Default program .... default(F) 

defopen, defread: Reads default entries defopen(S) 

directory, default: Default program information . . . default(F) 

Contains special character definitions for eqn. eqnchar: . . . eqnchar(CT) 

entries, defopen, defread: Reads default . . defopen(S) 

defopen, defread: Reads default entries. . . defopen(S) 

Performs/ dbminit, fetch, store, delete, firstkey, nextkey: .... dbm(S) 

rmdir: Deletes a directory rmdir(DOS) 

pathname, dirname: Delivers directory part of .... dirname(C) 

file, tail: Delivers the last part of a .... tail(C) 

delta: Makes a delta (change) to an SCCS file. . . delta(CP) 

delta, cdc: Changes the delta commentary of an SCCS . . cdc(CP) 

rmdel: Removes a delta from an SCCS file rmdel(CP) 

an SCCS file, delta: Makes a delta (change) to . delta(CP) 

the delta commentary of an SCCS delta, cdc: Changes cdc(CP) 

comb: Combines SCCS deltas comb(CP) 

terminal, mesg: Permits or deniesmessages sent to a .... mesg(C) 

tbl, and eqn constructs, deroff: Removes nroff/troff, . . . deroff(CT) 

terminfo: terminal description database terminfo(S) 

Machine: Description of host machine. . . . machine(HW) 

messages, messages: Description of system console . . messages(M) 

segread: command description segread(DOS) 

capinfo: convert termcap descriptions into terminfo/ .... capinfo(C) 

descriptions into terminfo descriptions, /convert termcap . . capinfo(C) 

close: Closes a file descriptor close(S) 

dup2: Duplicates an open file descriptor, dup, dup(S) 

sdget, sdfree: Attaches and detaches a shared data segment. . sdget(S) 

file, access: Determines accessibility of a ... access(S) 

dtype: Determines disk type dtype(C) 

eof: Determines end-of-file eof(DOS) 

hypot, cabs: Determines Euclidean distance. . . hypot(S) 

file: Determines file type. file(C) 
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for C programs, stackuse: Determines stack requirements . . stackuse(CP) 

ferror, feof, clearerr, fileno: Determines stream status ferror(S) 

whodo: Determines who is doing what. . . whodo(C) 

console: System console device console(M) 

error: Kernel error output device error(M) 

/Default backup device information archive(F) 

master: Master device information table master(F) 

lp, lpO, lpl, lp2: Line printer device interfaces lp(HW) 

isatty: Checks for a character device isatty(DOS) 

mapchan: Format of tty device mapping files mapchan(F) 

mapchan: Configure tty device mapping mapchan(M) 

devnm: Identifies device name devnm(C) 

systty: System maintenance device systty(M) 

ioctl: Controls character devices ioctl(S) 

deassign: Assigns and deassigns devices, assign, assign(C) 

font and video mode for a video device, vidi: Sets the vidi(C) 

devnm: Identifies device name. . . devnm(C) 

blocks, df: Report number of free disk . . df(C) 

dial: Dials a modem dial(ADM) 

terminal line connection, dial: Establishes an out-going . . dial(S) 

dial: Dials a modem dial(ADM) 

uuchat: dials a modem dial(ADM) 

diction: Checks language usage. . diction(CT) 

diff: Compares two text files. . . . diff(C) 

difB: Compares three files. . . . diff3(C) 

diffink: Marks differences between files diffmk(CT) 

between files, diffink: Marks differences .... diffmk(CT) 

dir: Format of a directory dir(F) 

dircmp: Compares directories. . . dircmp(C) 

uucheck: check the uucp directories and permissions file . . uucheck(ADM) 

dircmp: Compares directories dircmp(C) 

mv: Moves or renames files and directories mv(C) 

rm, rmdir: Removes files or directories rm(C) 

rmdir: Removes directories rmdir(C) 

information about contents of directories. Is: Gives ls(C) 

cd: Changes working directory cd(C) 

chdir: Changes the working directory chdir(S) 

chroot: / Changes the root directory chroot(S) 

uuclean: uucp spool directory clean-up uuclean(ADM) 

lc: Lists directory contents in columns. . . lc(C) 

dir: Format of a directory dir(F) 

unlink: Removes directory entry unlink(S) 

chroot: Changes root directory for command chroot(ADM) 

uucico: Scan the spool directory for work uucico(C) 

mkdir: Makes a directory mkdir(C) 

mkdir: Creates a new directory mkdir(DOS) 

mvdir: Moves a directory mvdir(C) 

pwd: Prints working directory name pwd(C) 

basename: Removes directory names from pathnames. . basename(C) 

closedir: Performs directory operations directory(S) 

ordinary file, mknod: Makes a directory, or a special or ..... mknod(S) 
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dirname: Delivers directory part of pathname. . . . dirname(C) 

rename: renames a file or directory rename(DOS) 

rmdir: Deletes a directory rmdir(DOS) 

access permissions of a file or directory, chmod: Changes the . . chmod(C) 

Default program information directory, default: default(F) 

the pathname of current working directory, getcwd: Get getcwd(S) 

information about contents of directory. 1: Lists 1(C) 

of pathname, dirname: Delivers directory part . dirname(C) 

printers, disable: Turns off terminals and . . disable(C) 

acct: Enables or disables process accounting. . . . acct(S) 

type, modes, speed, and line discipline. /Sets terminal .... getty(M) 

cmchk: Reports hard disk block size cmchk(C) 

df: Report number of free disk blocks df(C) 

dparam: Displays/changes hard disk characteristics dparam(ADM) 

hd: Internal hard disk drive hd(HW) 

track/ badtrk: Scans fixed disk for flaws and creates bad . . badtrk(ADM) 

fdisk: Maintain disk partitions fdisk(ADM) 

dtype: Determines disk type dtype(C) 

du: Summarizes disk usage du(C) 

floppy disks, diskcp, diskcmp: Copies or compares . . diskcp(C) 

compares floppy disks, diskcp, diskcmp: Copies or ... diskcp(C) 

format: format floppy disks format(C) 

Copies or compares floppy disks, diskcp, diskcmp: diskcp(C) 

umount: Dismounts a file structure umount(ADM) 

zcat: Display a stored file compress(C) 

vedit: Invokes a screen-oriented display editor, vi, view, vi(C) 

configuration data base, cmos: Displays and sets the cmos(HW) 

cat: Concatenates and displays files cat(C) 

format, hd: Displays files in hexadecimal . . . hd(C) 

od: Displays files in octal format. . . . od(C) 

system activity, uptime: Displays information about . . . uptime(C) 

is on the system and what w: Displays information about who . w(C) 

prof: Displays profile data prof(CP) 

executable binary files, hdr: Displays selected parts of .... hdr(CP) 

characteristics, dparam: Displays/changes hard disk . . . dparam(ADM) 

mail: Sends, reads or disposes of mail mail(C) 

cabs: Determines Euclidean distance, hypot, hypot(S) 

lcong48: Generates uniformly distributed. srand48, seed48, . . . drand48(S) 

divvy -b block_device -c c/ . . divvy(ADM) 

mm macros, mm: Prints documents formatted with the . . mm(CT) 

mmt: Typesets documents mmt(CT) 

Analyzes characteristics of a document, style: style(CT) 

whodo: Determines who is doing what whodo(C) 

intro: Introduction to DOS cross development functions. intro(DOS) 

dosexterr: Gets DOS error messages dosexter(DOS) 

dosls, dosrm, dosrmdir: Access DOS files dos(C) 

bdos: Invokes a DOS system call bdos(DOS) 

intdos: Invokes a DOS system call intdos(DOS) 

intdosx: Invokes a DOS system call intdosx(DOS) 

messages, dosexterr: Gets DOS error .... dosexter(DOS) 

linker, dosld: XENIX to MS-DOS cross . dosld(CP) 
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DOS files, dosls, dosrm, dosrmdir: Access . . dos(C) 

files, dosls, dosrm, dosrmdir: Access DOS . . dos(C) 

dosls, dosrm, dosrmdir: Access DOS files. . . . dos(C) 

/atof: Converts a string to a double-precision number strtod(S) 

disk characteristics, dparam: Displays/changes hard . . dparam(ADM) 

hd: Internal hard disk drive hd(HW) 

Swaps default boot floppy drive, fdswap: fdswap(ADM) 

utility, sysadmsh: Menu driven system administration . . . sysadmsh(ADM) 

sxt: Pseudo-device driver sxt(M) 

term: Terminal driving tables for nroff. term(F) 

dtype: Determines disk type. . . . dtype(C) 

du: Summarizes disk usage. . . . du(C) 

format, dump: Incremental dump tape . . dump(F) 

system backup, dump: Performs incremental file . dump(C) 

backup: Incremental dump tape format backup(F) 

dump: Incremental dump tape format dump(F) 

files on a backup archive, dumpdir: Prints the names of . . . dumpdir(C) 

file, tapedump: Dumps magnetic tape to output . . tapedump(C) 

file descriptor, dup, dup2: Duplicates an open . . dup(S) 

descriptor, dup, dup2: Duplicates an open file ... dup(S) 

descriptor, dup, dup2: Duplicates an open file dup(S) 

dviimp: Convert DVI files to imPRESS format. . . dviimp(CT) 

iprint: Converts text files to DVI format iprint(C) 

imPRESS format, dviimp: Convert DVI files to . . . dviimp(CT) 

echo: Echoes arguments echo(C) 

getche: Gets and echoes a character getche(DOS) 

echo: Echoes arguments echo(C) 

output conversions, ecvt, fcvt, gcvt: Performs .... ecvt(S) 

ed: Invokes the text editor. .... ed(C) 

program, end, etext, edata: Last locations in end(S) 

sact: Prints current SCCS file editing activity sact(CP) 

ed: Invokes the text editor ed(C) 

ex: Invokes a text editor ex(C) 

Id: Invokes the link editor ld(CP) 

Id: Invokes the link editor ld(M) 

Format of assembler and link editor output. a.out: a.out(F) 

the stream editor, sed: Invokes sed(C) 

a screen-oriented display editor, /view, vedit: Invokes . . . vi(C) 

effective user, real group, and effective group IDs. /real user, . . getuid(S) 

/getgid, getegid: Gets real user, effective user, real group, and/ . . getuid(S) 

color, monochrome, ega,. /tty[01-n], screen(HW) 

for a pattern, grep, egrep, fgrep: Searches a file ... grep(C) 

input, soelim: Eliminates .so's from nroff .... soelim(CT) 

line printers, enable: Turns on terminals and . . enable(C) 

accounting, acct: Enables or disables process . . . acct(S) 

format and human-readable/ deco, enco: Convert between imPRESS . deco(CT) 

transmission via mail uuencode: encode a binary file for uuencode(C) 

makekey: Generates an encryption key makekey(M) 

locations in program, end, etext, edata: Last end(S) 

/getgrgid, getgrnam, setgrent, endgrent: Get group file entry. . . getgrent(S) 

eof: Determines end-of-file eof(DOS) 
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/getpwuid, getpwnam, setpwent, endpwent: Gets password file/ . . getpwent(S) 

utmp file entry, endutent, utmpname: Accesses . • getut(S) 

defopen, defread: Reads default entries defopen(S) 

xlist, fxlist: Gets name list entries from files xlist(S) 

nlist: Gets entries from name list nlist(S) 

wtmp: Formats of utmp and wtmp entries, utmp, utmp(F) 

putpwent: Writes a password file entry putpwent(S) 

unlink: Removes directory entry unlink(S) 

utmpname: Accesses utmp file entry, endutent, getut(S) 

endgrent: Get group file entry, /getgrnam, setgrent, .... getgrent(S) 

endpwent: Gets password file entry, /getpwnam, setpwent, . . . getpwent(S) 

command execution, env: Sets environment for .... env(C) 

environ: The user environment. . . environ(M) 

profile: Sets up an environment at login time profile(M) 

environ: The user environment environ(M) 

execution, env: Sets environment for command .... env(C) 

getenv: Gets value for environment name getenv(S) 

putenv: Changes or adds value to environment putenv(S) 

TZ: Time zone environment variable tz(M) 

eof: Determines end-of-file. . . . eof(DOS) 

Removes nroff/troff, tbl, and eqn constructs, deroff: deroff(CT) 

Formats mathematical text for/ eqn, neqn, checkeq, eqncheck: . . eqn(CT) 

character definitions for eqn. eqnchar: Contains special .... eqnchar(CT) 

text for/ eqn, neqn, checkeq, eqncheck: Formats mathematical . eqn(CT) 

character definitions for eqn. eqnchar: Contains special . . eqnchar(CT) 

complementary error function, erf, erf c: Error function and . . . erf(S) 

complementary error/ erf, erfc: Error function and ..... erf(S) 

perror, sys_errlist, sys_nerr, errno: Sends system error/ .... perror(S) 

error function, erf, erfc: Error function and complementary erf(S) 

Error function and complementary error function, erf, erfc: erf(S) 

device, error: Kernel error output .... error(M) 

source, mkstr: Creates an error message file from C .... mkstr(CP) 

dosexterr: Gets DOS error messages dosexter(DOS) 

sys_nerr, errno: Sends system error messages. /sys_errlist, . . . perror(S) 

services, library routines and error numbers, /system Intro(S) 

error: Kernel error output device error(M) 

fsave: Interactive, error-checking filesystem backup . fsave(ADM) 

matherr: Error-handling function matherr(S) 

hashcheck: Finds spelling errors, /hashmake, spellin, .... spell(CT) 

terminal line connection, dial: Establishes an out-going .... dial(S) 

setmnt: Establishes /etc/mnttab table. . . . setmnt(ADM) 

setmnt: Establishes /etc/mnttab table setmnt(ADM) 

program, end, etext, edata: Last locations in . . . end(S) 

hypot, cabs: Determines Euclidean distance hypot(S) 

expression, expr: Evaluates arguments as an .... expr(C) 

ex: Invokes a text editor ex(C) 

execlp, execvp: Executes a/ execl, execv, execle, execve, . . . exec(S) 

Executes a file, execl, execv, execle, execve, execlp, execvp: . . exec(S) 

execl, execv, execle, execve, execlp, execvp: Executes a file. . . exec(S) 

executable, execseg: makes a data region . . . execseg(S) 

fixhdr: Changes executable binary file headers. . . fixhdr(C) 
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hdr: Displays selected parts of executable binary files hdr(CP) 

execseg: makes a data region executable execseg(S) 

execle, execve, execlp, execvp: Executes a file, execl, execv, . . exec(S) 

system: Executes a shell command. . . . system(S) 

int86: Executes an interrupt int86(DOS) 

int86x: Executes an interrupt int86x(DOS) 

XENIX, uux: Executes command on remote . . uux(C) 

time, at, batch: Executes commands at a later . . at(C) 

times, cron: Executes commands at specified . cron(C) 

XENIX system, remote: Executes commands on a remote . remote(C) 

xargs: Constructs and executes commands xargs(C) 

regex, regcmp: Compiles and executes regular expressions. . . . regex(S) 

nap: Suspends execution for a short interval. . . nap(S) 

sleep: Suspends execution for an interval sleep(C) 

sleep: Suspends execution for an interval sleep(S) 

monitor: Prepares execution profile monitor(S) 

profil: Creates an execution time profile profil(S) 

Sets environment for command execution, env: env(C) 

execvp: Executes a file., execl, execv, execle, execve, execlp, . . exec(S) 

a file, execl, execv, execle, execve, execlp, execvp: Executes . exec(S) 

execv, execle, execve, execlp, execvp: Executes a file, execl, . . exec(S) 

link: Links a new filename to an existing file link(S) 

a new file or rewrites an existing one. creat: Creates . . . creat(S) 

process, exit, _exit: Terminates a exit(S) 

exit, _exit: Terminates a process. . . . exit(S) 

process, exit: Terminates the calling . . . exit(DOS) 

false: Returns with a nonzero exit value false(C) 

true: Returns with a zero exit value true(C) 

Performs exponential,/ exp, log, pow, sqrt, loglO: .... exp(S) 

peat, unpack: Compresses and expands files, pack, pack(C) 

usage, explain: Corrects language .... explain(CT) 

/log, pow, sqrt, loglO: Performs exponential, logarithm, power,/ . . exp(S) 

number into a mantissa and an exponent. /Splits floating-point . . frexp(S) 

expression, expr: Evaluates arguments as an . expr(C) 

routines, regexp: Regular expression compile and match . . regexp(S) 

expr: Evaluates arguments as an expression expr(C) 

regcmp: Compiles regular expressions regcmp(CP) 

Compiles and executes regular expressions, regex, regcmp: . . . regex(S) 

programs, xstr: Extracts strings from C xstr(CP) 

absolute value, floor,/ floor, fabs, ceil, fmod: Performs .... floor(S) 

of inter-process communication facilities. /Reports the status . . . ipcs(ADM) 

factor: Factor a number factor(C) 

factor: Factor a number factor(C) 

faliases: Micnet aliasing files. . . aliases(M) 

exit value, false: Returns with a nonzero . . . false(C) 

abort: Generates an IOT fault abort(S) 

streams, fclose, fcloseall: Closes fclose(DOS) 

flushes a stream, fclose, fflush: Closes or fclose(S) 

fclose, fcloseall: Closes streams fclose(DOS) 

fcntl: Controls open files fcntl(S) 

conversions, ecvt, fevt, gcvt: Performs output .... ecvt(S) 
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fdisk: Maintain disk partitions. . . fdisk(ADM) 

fopen, freopen, fdopen: Opens a stream fopen(S) 

floppy drive, fdswap: Swaps default boot . . . fdswap(ADM) 

/to machine related miscellaneous features and files Intro(HW) 

Introduction to miscellaneous features and files, intro: Intro(M) 

Determines stream/ ferror, feof, clearerr, fileno: ferror(S) 

Determines stream status, ferror, feof, clearerr, fileno: . . . ferror(S) 

nextkey: Performs/ dbminit, fetch, store, delete, firstkey, . . . dbm(S) 

stream, fclose, fftush: Closes or flushes a .... fclose(S) 

character from a stream, fgetc, fgetchar: Gets a fgetc(DOS) 

word from a/ getc, getchar, fgetc, getw: Gets character or . . getc(S) 

a stream, fgetc, fgetchar: Gets a character from . . fgetc(DOS) 

stream, gets, fgets: Gets a string from a .... gets(S) 

pattern, grep, egrep, fgrep: Searches a file for a .... grep(C) 

Compares files too large for diff. bdiff: bdiff^C) 

cut: Cuts out selected fields of each line of a file cut(CT) 

of file systems processed by fsck. checklist: List checklist(F) 

times, utime: Sets file access and modification . . . utime(S) 

cpio: Copies file archives in and out cpio(C) 

chmod: Changes mode of a file chmod(S) 

chsize: Changes the size of a file chsize(S) 

uncompress: Uncompress a stored file compress(C) 

zcat: Display a stored file compress(C) 

uupick: Public XENIX-to-XENDC file copy, uuto, uuto(C) 

core: Format of core image file core(F) 

umask: Sets and gets file creation mask umask(S) 

ctags: Creates a tags file ctags(CP) 

dd: Converts and copies a file dd(C) 

close: Closes a file descriptor close(S) 

dup, dup2: Duplicates an open file descriptor dup(S) 

file: Determines file type file(C) 

sact: Prints current SCCS file editing activity sact(CP) 

putpwent: Writes a password file entry putpwent(S) 

utmpname: Accesses utmp file entry, endutent, getut(S) 

setgrent, endgrent: Get group file entry, /getgrgid, getgrnam, . . getgrent(S) 

endpwent: Gets password file entry, /getpwnam, setpwent, . getpwent(S) 

filelength: Gets the length of a file fileleng(DOS) 

grep, egrep, fgrep: Searches a file for a pattern grep(C) 

open: Opens file for reading or writing open(S) 

writing, sopen: Opens a file for shared reading and .... sopen(DOS) 

uudecode: decode a binary file for transmission via mail . . . uuencode(C) 

uuencode: encode a binary file for transmission via mail . . . uuencode(C) 

ar: Archive file format ar(F) 

intro: Introduction to file formats - . Intro(F) 

mkstr: Creates an error message file from C source mkstr(CP) 

group: Format of the group file group(M) 

grpcheck: Checks group file grpcheck(C) 

Changes executable binary file headers, fixhdr: fixhdr(C) 

split: Splits a file into pieces split(C) 

In: Makes a link to a file ln(C) 

mem, kmem: Memory image file mem(M) 



1-18 



Permuted Index 



nl: Adds line numbers to a file nl(C) 

null: The null file null(F) 

/Finds the slot in the utmp file of the current user ttyslot(S) 

rename: renames a file or directory rename(DOS) 

the access permissions of a file or directory. /Changes .... chmod(C) 

one. creat: Creates a new file or rewrites an existing .... creat(S) 

passwd: The password file passwd(F) 

/ftell, rewind: Repositions a file pointer in a stream fseek(S) 

lseek: Moves read/write file pointer lseek(S) 

Gets the current position of the file pointer, tell: tell(DOS) 

prs: Prints an SCCS file prs(CP) 

pwcheck: Checks password file pwcheck(C) 

read: Reads from a file read(S) 

locking: Locks or unlocks a file region for reading or/ .... locking(S) 

sccsfile: Format of an SCCS file sccsfile(F) 

stat, fstat: Gets file status stat(S) 

mount: Mounts a file structure mount(ADM) 

umount: Dismounts a file structure umount(ADM) 

backup: Performs incremental file system backup backup(C) 

dump: Performs incremental file system backup dump(C) 

files, sysadmin: Performs file system backups and restores . sysadmin(ADM) 

fsdb: File system debugger fsdb(ADM) 

volume, file system: Format of a system . . filesystem(F) 

mkfs: Constructs a file system mkfs(ADM) 

commands, fstab: File system mount and check . . . fstab(F) 

mount: Mounts a file system mount(S) 

quot: Summarizes file system ownership quot(C) 

restore, restor: Invokes incremental file system restorer restore(C) 

ustat: Gets file system statistics ustat(S) 

mnttab: Format of mounted file system table mnttab(F) 

umount: Unmounts a file system umount(S) 

haltsys, reboot: Closes out the file systems and shuts down the/ . haltsys(ADM) 

fsck: Checks and repairs file systems fsck(ADM) 

fsck. checklist: List of file systems processed by .... checklist(F) 

tmpfile: Creates a temporary file tmpfile(S) 

serial/ consoleprint: Print file to printer attached to a .... consoleprint(ADM) 

tsort: Sorts a file topologically tsort(CP) 

the scheduler for the uucp file transport program uusched: . . uusched(ADM) 

ftw:Walksa file tree ftw(S) 

ttys: Login terminals file ttys(F) 

file: Determines file type file(C) 

val: Validates an SCCS file val(CP) 

write: Writes to a file write(S) 

Determines accessibility of a file, access: access(S) 

Format of per-process accounting file, acct: acct(F) 

for and processes a pattern in a file, awk: Searches awk(C) 

troff width files and catab file, charmap: Generate charmap(CT) 

Changes the owner and group of a file, chown: chown(S) 

user login shell in password file, chsh: changes chsh(ADM) 

umask: Sets file-creation mode mask umask(C) 

fields of each line of a file, cut: Cuts out selected .... cut(CT) 
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a delta (change) to an SCCS file, delta: Makes delta(CP) 

execlp, execvp: Executes a file, /execv, execle, execve, . . . exec(S) 

Alternative login terminals file, inittab: inittab(F) 

file, filelength: Gets the length of a . . fileleng(DOS) 

a new filename to an existing file, link: Links link(S) 

The Micnet default commands file, micnet: micnet(F) 

or a special or ordinary file, mknod: Makes a directory, . . mknod(S) 

ctermid: Generates a filename for a terminal ctermid(S) 

mktemp: Makes a unique filename mktemp(S) 

link: Links a new filename to an existing file. ... link(S) 

Changes the format of a text file, newform: newform(C) 

status, ferror, feof, clearerr, fileno: Determines stream .... ferror(S) 

Removes a delta from an SCCS file, rmdel: rmdel(CP) 

csplit: Splits files according to context csplit(C) 

rep: Copies files across XENIX systems. . . . rcp(C) 

faliases: Micnet aliasing files aliases(M) 

charmap: Generate troff width files and catab file charmap(CT) 

mv: Moves or renames files and directories mv(C) 

bfs: Scans big files bfs(C) 

cat: Concatenates and displays files cat(C) 

cmp: Compares two files cmp(C) 

copy: Copies groups of files copy(C) 

cp: Copies files cp(C) 

difB: Compares three files diffi(C) 

diff: Compares two text files diff(C) 

fcntl: Controls open files fcntl(S) 

find: Finds files find(C) 

translate: Translates files from one format to another . . translate(C) 

hd: Displays files in hexadecimal format. . . . hd(C) 

od: Displays files in octal format od(C) 

mknod: Builds special files. . mknod(C) 

dumpdir: Prints the names of files on a backup archive dumpdir(C) 

imprint: Prints text files on an IMAGEN printer. . . . imprint(C) 

imprint: print text files on an IMAGEN printer. . . . imprint(CT) 

pr: Prints files on the standard output. . . . pr(C) 

queue, ipr, oldipr: Put files onto the IMAGEN printer . . ipr(C) 

rm, rmdir: Removes files or directories rm(C) 

paste: Merges lines of files paste(CT) 

sdiff: Compares files side-by-side sdiff(C) 

sort: Sorts and merges files sort(C) 

tar: Archives files tar(C) 

iprint: Converts text files to DVI format iprint(C) 

catimp: Convert C/A/T files to imPRESS format catimp(CT) 

dviimp: Convert DVI files to imPRESS format dviimp(CT) 

for printing. Ipr: Sends files to the lineprinter queue . . . lpr(C) 

coffconv: Convert 386 COFF files to XENIX format coffconv(M) 

bdiff: Compares files too large for diff. bdiff(C) 

control files, uuinstall: Administers UUCP uuinstall(ADM) 

what: Identifies files what(C) 

and prints process accounting files, acctcom: Searches for ... acctcom(ADM) 

Creates and administers SCCS files, admin: admin(CP) 
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Compares two versions of an SCCS file, sccsdiff: sccsdiff(CP) 

lines common to two sorted files, comm: Selects or rejects . . comm(C) 

Marks differences between files, diffink: diffmk(CT) 

dosrm, dosrmdir: Access DOS files, dosls, dos(C) 

parts of executable binary files, hdr: Displays selected . . . hdr(CP) 

to miscellaneous features and files, intro: Introduction Intro(M) 

Prints the size of an object file, size: size(CP) 

semaphores and record locking on files, lockf: Provide lockf(S) 

Format of tty device mapping files, mapchan: mapchan(F) 

unpack: Compresses and expands files, pack, peat, pack(C) 

access and modification dates of files, settime: Changes the ... . settime(ADM) 

file system backups and restores files, sysadmin: Performs .... sysadmin(ADM) 

miscellaneous features and files, /to machine related .... Intro(HW) 

top.next: The Micnet topology files, top, top(F) 

printable strings in an object file, strings: Finds the strings(CP) 

checksum and counts blocks in a file, sum: Calculates sum(C) 

Gets name list entries from files, xlist, fxlist: xlist(S) 

Interactive, error-checking filesystem backup fsave: .... fsave(ADM) 

mnt: Mount a filesystem mnt(C) 

The Micnet system identification file, systemid: systemid(F) 

/Default information for mounting filesystems filesys(F) 

Delivers the last part of a file, tail: tail(C) 

Dumps magnetic tape to output file, tapedump: tapedump(C) 

Format of compiled terminfo file, terminfo: terminfo(F) 

Creates a name for a temporary file, tmpnam, tempnam: tmpnam(S) 

and modification times of a file, touch: Updates access . . . touch(C) 

Undoes a previous get of an SCCS file, unget: unget(CP) 

Reports repeated lines in a file, uniq: uniq(C) 

uucp directories and permissions file uucheck: check the uucheck(ADM) 

col: Filters reverse linefeeds col(CT) 

documents formatted with the mm macros, mm: Prints mm(CT) 

find: Finds files find(C) 

hyphen: Finds hyphenated words hyphen(CT) 

finger: Finds information about users. . . finger(C) 

look: Finds lines in a sorted list look(CT) 

logname: Finds login name of user logname(S) 

object library, lorder: Finds ordering relation for an ... lorder(CP) 

hashmake, spellin, hashcheck: Finds spelling errors, spell, . . . spell(CT) 

ttyname, isatty: Finds the name of a terminal. . . . ttyname(S) 

an object file, strings: Finds the printable strings in ... strings(CP) 

of the current user, ttyslot: Finds the slot in the utmp file ... ttyslot(S) 

users, finger: Finds information about . . finger(C) 

dbminit, fetch, store, delete, firstkey, nextkey: Performs/ . . . dbm(S) 

/Prints formatted output of a varargs argument list vprintf(S) 

bad track table, badtrk: Scans fixed disk for flaws and creates . . badtrk(ADM) 

binary file headers, fixhdr: Changes executable . . . fixhdr(C) 

badtrk: Scans fixed disk for flaws and creates bad track/ ... badtrk(ADM) 

frexp, Idexp, modf: Splits floating-point number into a/ . . . frexp(S) 

/fmod: Performs absolute value, floor, ceiling and remainder/ . . . floor(S) 

Performs absolute value, floor,/ floor, fabs, ceil, fmod: floor(S) 

format: format floppy disks format(C) 
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diskcmp: Copies or compares floppy disks, diskcp, diskcp(C) 

fdswap: Swaps default boot floppy drive fdswap(ADM) 

cflow: Generates C flow graph cflow(CP) 

buffers, flushall: Flushes all output .... flushall(DOS) 

fclose, fflush: Closes or flushes a stream fclose(S) 

flushall: Flushes all output buffers flushall(DOS) 

CPU. shutdn: Flushes block I/O and halts the . . shutdn(S) 

floor,/ floor, fabs, ceil, fmod: Performs absolute value, . . floor(S) 

device, vidi: Sets the font and video mode for a video . . vidi(C) 

stream, fopen, freopen, fdopen: Opens a . fopen(S) 

fork: Creates a new process. . . . fork(S) 

enco: Convert between imPRESS format and human-readable/ deco, deco(CT) 

ar: Archive file format ar(F) 

backup: Incremental dump tape format backup(F) 

dump: Incremental dump tape format dump(F) 

format: format floppy disks format(C) 

86rel: Intel 8086 Relocatable Format for Object Modules. . . . 86rel(F) 

format: format floppy disks. . . . format(C) 

od: Displays files in octal format od(C) 

dir: Format of a directory dir(F) 

file system: Format of a system volume. . . . filesystem(F) 

newform: Changes the format of a text file newform(C) 

inode: Format of an inode inode(F) 

sccsfile: Format of an SCCS file sccsfile(F) 

editor output, a.out: Format of assembler and link . . . a.out(F) 

file, terminfo: Format of compiled terminfo . . . terminfo(F) 

core: Format of core image file core(F) 

cpio: Format of cpio archive cpio(F) 

table, mnttab: Format of mounted file system . . mnttab(F) 

file, acct: Format of per-process accounting . acct(F) 

group: Format of the group file group(M) 

files, mapchan: Format of tty device mapping . . mapchan(F) 

tar: archive format tar(F) 

Translates files from one format to another translate: . . . translate(C) 

Convert C/A/T files to imPRESS format, catimp: catimp(CT) 

Convert 386 COFF files to XENIX format, coffconv: coffconv(M) 

format and human-readable format. /Convert between imPRESS deco(CT) 

Convert DVI files to imPRESS format, dviimp: dviimp(CT) 

Displays files in hexadecimal format, hd: hd(C) 

Converts text files to DVI format, iprint: iprint(C) 

cscanf: Converts and formats console input cscanf(DOS) 

fscanf, sscanf: Converts and formats input, scanf, scanf(S) 

intro: Introduction to file formats Intro(F) 

eqn, neqn, checkeq, eqncheck: Formats mathematical text for/ . . eqn(CT) 

neqn: Formats mathematics neqn(CT) 

entries, utmp, wtmp: Formats of utmp and wtmp .... utmp(F) 

cprintf: Formats output cprintf(DOS) 

printf, fprintf, sprintf: Formats output printf(S) 

troff. tbl: Formats tables for nroff or .... tbl(CT) 

vfprintf, vsprintf: Prints formatted output of a/ vprintf, . . vprintf(S) 

macros, mm: Prints documents formatted with the mm mm(CT) 
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nroff: A text formatter nroff(CT) 

ratfor: Converts Rational FORTRAN into standard FORTRAN. ratfor(CP) 

Rational FORTRAN into standard FORTRAN, ratfor: Converts . . . ratfor(CP) 

and segment. fp_off, fp_seg: Return offset . . . fp_seg(DOS) 

output, printf, fprintf, sprintf: Formats printf(S) 

segment. fp_off, fp_seg: Return offset and .... fp_seg(DOS) 

character to a stream, fputc, fputchar: Write a fputc(DOS) 

word on a/ putc, putchar, fputc, putw: Puts a character or . . putc(S) 

stream, fputc, fputchar: Write a character to a . . fputc(DOS) 

stream, puts, fputs: Puts a string on a puts(S) 

binary input and output, fread, fwrite: Performs buffered . . fread(S) 

main memory, malloc, free, realloc, calloc: Allocates . . malloc(S) 

fopen, freopen, fdopen: Opens a stream. . fopen(S) 

floating-point number into a/ frexp, Idexp, modf: Splits .... frexp(S) 

error-checking filesystem/ fsave: Interactive, fsave(ADM) 

formats input, scanf, fscanf, sscanf: Converts and . . . scanf(S) 

systems, fsck: Checks and repairs file . . . fsck(ADM) 

fsdb: File system debugger. . . . fsdb(ADM) 

Repositions a file pointer in a/ fseek, ftell, rewind: fseek(S) 

semi-automated system backups fsphoto: Performs periodic .... fsphoto(ADM) 

check commands, fstab: File system mount and . . . fstab(F) 

stat, fstat: Gets file status stat(S) 

file pointer in a/ fseek, ftell, rewind: Repositions a ... fseek(S) 

time, ftime: Gets time and date time(S) 

communication package, ftok: Standard interprocess .... stdipc(S) 

ftw: Walks a file tree ftw(S) 

function, erf, erfc: Error function and complementary error . erf(S) 

gamma: Performs log gamma function gamma(S) 

setkey: Assigns the function keys setkey(C) 

matherr: Error-handling function matherr(S) 

function and complementary error function, erf, erfc: Error .... erf(S) 

floor, ceiling and remainder functions, /absolute value, .... floor(S) 

atan2: Performs trigonometric functions, /asin, acos, atan, . . . trig(S) 

jn, yO, yl, yn: Performs Bessel functions, bessel, jO, jl, bessel(S) 

Performs screen and cursor functions, curses: curses(S) 

nextkey: Performs database functions, /delete, firstkey, . . . dbm(S) 

logarithm, power, square root functions, /exponential, exp(S) 

to DOS cross development functions, intro: Introduction . . intro(DOS) 

cosh, tanh: Performs hyperbolic functions, sinh, sinh(S) 

tgoto, tputs: Performs terminal functions, /tgetflag, tgetstr, . . . termcap(S) 

input and output, fread, fwrite: Performs buffered binary . fread(S) 

from files, xlist, fxlist: Gets name list entries . . . xlist(S) 

gamma: Performs log gamma function gamma(S) 

function, gamma: Performs log gamma . . . gamma(S) 

conversions, ecvt, fcvt, gcvt: Performs output ecvt(S) 

adb: Invokes a general-purpose debugger adb(CP) 

report, imacct: Generate an IMAGEN accounting . imacct(C) 

catab file, charmap: Generate troff width files and . . . charmap(CT) 

terminal, ctermid: Generates a filename for a .... ctermid(S) 

ptx: Generates a permuted index. . . . ptx(CT) 

random: Generates a random number. . . . random(C) 
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rand, srand: Generates a random number. . . . rand(S) 

makekey: Generates an encryption key. . . . makekey(M) 

abort: Generates an IOT fault abort(S) 

cflow: Generates C flow graph cflow(CP) 

cross-reference, cxref: Generates C program cxref(CP) 

numbers, ncheck: Generates names from inode . . . ncheck(ADM) 

analysis, lex: Generates programs for lexical . . lex(CP) 

srand48, seed48, lcong48: Generates uniformly distributed. . drand48(S) 

Micnet alias hash table generator, aliashash: aliashash(ADM) 

character or word from a/ getc, getchar, fgetc, getw: Gets . . getc(S) 

getch: Gets a character getch(DOS) 

character or word from a/ getc, getchar, fgetc, getw: Gets .... getc(S) 

character, getche: Gets and echoes a .... getche(DOS) 

current working directory, getcwd: Get the pathname of . . . getcwd(S) 

getuid, geteuid, getgid, getegid: Gets real user,/ getuid(S) 

environment name, getenv: Gets value for getenv(S) 

real user, effective/ getuid, geteuid, getgid, getegid: Gets . . . getuid(S) 

effective/ getuid, geteuid, getgid, getegid: Gets real user, . . getuid(S) 

setgrent, endgrent: Get group/ getgrent, getgrgid, getgrnam, . . . getgrent(S) 

endgrent: Get group/ getgrent, getgrgid, getgrnam, setgrent, . . . getgrent(S) 

Get group/ getgrent, getgrgid, getgrnam, setgrent, endgrent: . . . getgrent(S) 

getlogin: Gets login name getlogin(S) 

argument vector, getopt: Gets option letter from . . getopt(S) 

getopt: Parses command options. . getopt(C) 

getpass: Reads a password. . . . getpass(S) 

process group, and/ getpid, getpgrp, getppid: Gets process, . . getpid(S) 

process, process group, and/ getpid, getpgrp, getppid: Gets . . getpid(S) 

group, and/ getpid, getpgrp, getppid: Gets process, process . . getpid(S) 

user ID. getpw: Gets password for a given . getpw(S) 

setpwent, endpwent: Gets/ getpwent, getpwuid, getpwnam, . . getpwent(S) 

Gets/ getpwent, getpwuid, getpwnam, setpwent, endpwent: . getpwent(S) 

endpwent: Gets/ getpwent, getpwuid, getpwnam, setpwent, . . getpwent(S) 

fgetc, f getchar: Gets a character from a stream. . . fgetc(DOS) 

getch: Gets a character getch(DOS) 

shmget: Gets a shared memory segment. . . shmget(S) 

cgets: Gets a string cgets(DOS) 

gets, fgets: Gets a string from a stream. . . . gets(S) 

input, gets: Gets a string from the standard . . gets(CP) 

getche: Gets and echoes a character. . . . getche(DOS) 

ulimit: Gets and sets user limits ulimit(S) 

getc, getchar, fgetc, getw: Gets character or word from a/ . . getc(S) 

dosexterr: Gets DOS error messages. .... dosexter(DOS) 

nlist: Gets entries from name list. . . . nlist(S) 

a stream, gets, fgets: Gets a string from . . . gets(S) 

umask: Sets and gets file creation mask umask(S) 

stat, fstat: Gets file status stat(S) 

ustat: Gets file system statistics ustat(S) 

standard input, gets: Gets a string from the . . . gets(CP) 

getlogin: Gets login name getlogin(S) 

logname: Gets login name logname(C) 

msgget: Gets message queue msgget(S) 
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files, xlist, fxlist: Gets name list entries from . . . xlist(S) 

system, uname: Gets name of current XENIX . . . uname(S) 

vector, getopt: Gets option letter from argument . getopt(S) 

/getpwnam, setpwent, endpwent: Gets password file entry getpwent(S) 

ID. getpw: Gets password for a given user . . getpw(S) 

times, times: Gets process and child process . . times(S) 

getpid, getpgrp, getppid: Gets process, process group, and/ . getpid(S) 

real/ /geteuid, getgid, getegid: Gets real user, effective user, . . . getuid(S) 

semget: Gets set of semaphores semget(S) 

file pointer, tell: Gets the current position of the . . tell(DOS) 

filelength: Gets the length of a file fileleng(DOS) 

cuserid: Gets the login name of the user. . . cuserid(S) 

tty: Gets the terminal's name tty(C) 

time, ftime: Gets time and date time(S) 

getenv: Gets value for environment name. . getenv(S) 

modes, speed, and line/ getty: Sets terminal type, .... getty(M) 

ct: spawn getty to a remote terminal .... ct(C) 

settings used by getty. gettydefs: Speed and terminal . . gettydefs(F) 

and terminal settings used by getty. gettydefs: Speed gettydefs(F) 

getegid: Gets real user,/ getuid, geteuid, getgid, getuid(S) 

from a/ getc, getchar, fgetc, getw: Gets character or word . . . getc(S) 

of directories. Is: Gives information about contents . ls(C) 

date and time/ ctime, localtime, gmtime, asctime, tzset: Converts . ctime(S) 

longjmp: Performs a nonlocal "goto", setjmp, setjmp(S) 

and checks access to a resource governed by a semaphore. /Awaits waitsem(S) 

cflow: Generates C flow graph cflow(CP) 

file for a pattern, grep, egrep, fgrep: Searches a . . grep(C) 

/real user, effective user, real group, and effective group IDs. . . getuid(S) 

/getppid: Gets process, process group, and parent process IDs. . . getpid(S) 

newgrp: Logs user into a new group newgrp(C) 

copy: Copies groups of files copy(C) 

updates, and regenerates groups of programs. /Maintains, . make(CP) 

grpcheck: Checks group file. . . . grpcheck(C) 

signals, ssignal, gsignal: Implements software . . ssignal(S) 

shutdn: Flushes block I/O and halts the CPU shutdn(S) 

file systems and shuts down the/ haltsys, reboot: Closes out the . . haltsys(ADM) 

serial sequence packet protocol handler, ips: Imagen ips(ADM) 

ips, isbs, ipbs: IMAGEN protocol handlers ips(ADM) 

nohup: Runs a command immune to hangups and quits nohup(C) 

cmchk: Reports hard disk block size cmchk(C) 

dparam: Displays/changes hard disk characteristics dparam(ADM) 

hd: Internal hard disk drive hd(HW) 

hcreate, hdestroy: Manages hash search tables, hsearch, . . . hsearch(S) 

aliashash: Micnet alias hash table generator aliashash(ADM) 

spell, hashmake, spellin, hashcheck: Finds spelling/ .... spell(CT) 

Finds spelling errors, spell, hashmake, spellin, hashcheck: . . spell(CT) 

search tables, hsearch, hcreate, hdestroy: Manages hash . hsearch(S) 

hexadecimal format, hd: Displays files in hd(C) 

hd: Internal hard disk drive. . . . hd(HW) 

tables, hsearch, hcreate, hdestroy: Manages hash search . . hsearch(S) 

executable binary files, hdr: Displays selected parts of . . hdr(CP) 
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Changes executable binary file headers, fixhdr. fixhdr(C) 

user, hello: Send a message to another . hello(ADM) 

program, assert: Helps verify validity of assert(S) 

hd: Displays files in hexadecimal format hd(C) 

Machine: Description of host machine machine(HW) 

Manages hash search tables, hsearch, hcreate, hdestroy: .... hsearch(S) 

between imPRESS format and human-readable format. /Convert . deco(CT) 

information, hwconfig: Read the configuration . hwconfig(ADM) 

sinh, cosh, tanh: Performs hyperbolic functions sinh(S) 

hyphen: Finds hyphenated words. . hyphen(CT) 

hyphen: Finds hyphenated words hyphen(CT) 

Euclidean distance, hypot, cabs: Determines hypot(S) 

chgrp: Changes group ID chgrp(C) 

chown: Changes owner ID chown(C) 

and names, id: Prints user and group IDs . . . id(C) 

setpgrp: Sets process group ID setpgrp(S) 

mkuser: Adds a login ID to the system mkuser(ADM) 

systemid: The Micnet system identification file systemid(F) 

devnm: Identifies device name devnm(C) 

what: Identifies files what(C) 

Gets password for a given user ID. getpw: getpw(S) 

idleout: Logs out idle users idleout(ADM) 

idleout: Logs out idle users. . . . idleout(ADM) 

id: Prints user and group IDs and names id(C) 

group, and parent process IDs. /Gets process, process . . . getpid(S) 

real group, and effective group IDs. /real user, effective user, . . getuid(S) 

setgid: Sets user and group IDs. setuid, setuid(S) 

accounting report, imacct: Generate an IMAGEN . . imacct(C) 

core: Format of core image file core(F) 

mem, kmem: Memory image file mem(M) 

imacct: Generate an IMAGEN accounting report. . . . imacct(C) 

imprint: Prints text files on an IMAGEN printer imprint(C) 

imprint: print text files on an IMAGEN printer imprint(CT) 

/imagen.spp, imagen.remote: IMAGEN printer interface/ . . . imagen(M) 

itroff: Troff to an IMAGEN printer itroff(CT) 

ipr, oldipr: Put files onto the IMAGEN printer queue ipr(Q 

ips, isbs, ipbs: IMAGEN protocol handlers. . . . ips(ADM) 

protocol handler, ips: Imagen serial sequence packet . . ips(ADM) 

imagen.remote:/ imagen.sbs, imagen.pbs, imagen.spp, .... imagen(M) 

/imagen.pbs, imagen.spp, imagen.remote: IMAGEN printer/ . imagen(M) 

imagen.spp, imagen.remote:/ imagen.sbs, imagen.pbs, imagen(M) 

MAGEN/ imagen.sbs, imagen.pbs, imagen.spp, imagen.remote: . . . imagen(M) 

nohup: Runs a command immune to hangups and quits. . . nohup(C) 

ssignal, gsignal: Implements software signals. . . . ssignal(S) 

deco, enco: Convert between imPRESS format and/ deco(CT) 

catimp: Convert C/A/T files to imPRESS format catimp(CT) 

dviimp: Convert DVI files to imPRESS format dviimp(CT) 

IMAGEN printer, imprint: print text files on an ... imprint(CT) 

IMAGEN printer, imprint: Prints text files on an . . imprint(C) 

backup: Incremental dump tape format. . . backup(F) 

dump: Incremental dump tape format. . . dump(F) 
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backup: Performs incremental file system backup. . . backup(C) 

dump: Performs incremental file system backup. . . dump(C) 

restore, restor: Invokes incremental file system/ restore(C) 

ptx: Generates a permuted index ptx(CT) 

and teletypes last: Indicate last logins of users . . • last(C) 

/Default backup device information archive(F) 

hwconfig: Read the configuration information hwconfig(ADM) 

pstat: Reports system information pstat(C) 

prints lineprinter status information, lpstat: lpstat(C) 

initialization, init, inir: Process control init(M) 

initialization, init, inir: Process control .... init(M) 

init, inir: Process control initialization init(M) 

process, popen, pclose: Initiates I/O to or from a popen(S) 

terminals file, inittab: Alternative login .... inittab(F) 

clri: Clears inode clri(ADM) 

inode: Format of an inode inode(F) 

inode: Format of an inode inode(F) 

ncheck: Generates names from inode numbers ncheck(ADM) 

inp: Returns a byte inp(DOS) 

fwrite: Performs buffered binary input and output, fread, fread(S) 

Performs standard buffered input and output, stdio: stdio(S) 

Pushes character back into input stream, ungetc: ungetc(S) 

usemouse: Maps mouse input to keystrokes usemouse(C) 

Converts and formats console input, cscanf: cscanf(DOS) 

Gets a string from the standard input, gets: gets(CP) 

sscanf: Converts and formats input, scanf, fscanf, scanf(S) 

Eliminates .so's from nroff input, soelim: soelim(CT) 

uustat: uucp status inquiry and job control uustat(C) 

script, install: Installation shell install(M) 

install: Installation shell script install(M) 

creatsem: Creates an instance of a binary semaphore. . . creatsem(S) 

int86: Executes an interrupt. . . . int86(DOS) 

int86x: Executes an interrupt. . . int86x(DOS) 

call, intdos: Invokes a DOS system . . intdos(DOS) 

call, intdosx: Invokes a DOS system . . intdosx(DOS) 

abs: Returns an integer absolute value abs(S) 

/164a: Converts between long integer and base 64 ASCII. . . . a641(S) 

sputl, sgetl: Accesses long integer data in a/ sputl(S) 

the absolute value of a long integer, labs: Returns labs(DOS) 

/ltol3: Converts between 3-byte integers and long integers 13tol(S) 

itoa: Converts numbers to integers itoa(DOS) 

ltoa: Converts long integers to characters Itoa(DOS) 

between 3-byte integers and long integers. /ltol3: Converts .... 13tol(S) 

atol, atoi: Converts string to integer, strtol, strtol(S) 

for Object Modules. 86rel: Intel 8086 Relocatable Format . . 86rel(F) 

filesystem backup fsave: Interactive, error-checking .... fsave(ADM) 

imagen.remote: IMAGEN printer interface scripts, /imagen.spp, . . imagen(M) 

scsi: Small computer systems interface scsi(HW) 

termio: General terminal interface termio(M) 

/, tty2[a-h] , tty2[A-H]: Interface to serial ports serial(HW) 

tty: Special terminal interface tty(M) 
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lpl, lp2: Line printer device interfaces, lp, lpO, lp(HW) 

hd: Internal hard disk drive hd(HW) 

spline: Interpolates smooth curve spline(CP) 

sh: Invokes the shell command interpreter sh(C) 

csh: Invokes a shell command interpreter with C-like syntax. . . csh(C) 

a restricted shell (command interpreter), rsh: Invokes .... rsh(C) 

ipcs: Reports the status of inter-process communication/ . . ipcs(ADM) 

package, ftok: Standard interprocess communication . . . stdipc(S) 

pipe: Creates an interprocess pipe pipe(S) 

int86: Executes an interrupt int86(DOS) 

int86x: Executes an interrupt int86x(DOS) 

sleep: Suspends execution for an interval sleep(C) 

sleep: Suspends execution for an interval sleep(S) 

Suspends execution for a short interval, nap: nap(S) 

services, library routines and/ intro: Introduces system Intro(S) 

processing commands, intro: Introduces text Intro(CT) 

commands, intro: Introduces XENIX .... Intro(C) 

Development System commands, intro: Introduces XENIX .... Intro(CP) 

development functions, intro: Introduction to DOS cross . intro(DOS) 

formats, intro: Introduction to file .... Intro(F) 

miscellaneous features and/ intro: Introduction to Intro(M) 

related miscellaneous features/ intro: Introduction to machine . . Intro(HW) 

library routines and/ intro: Introduces system services, . . . Intro(S) 

commands, intro: Introduces text processing .... Intro(CT) 

intro: Introduces XENIX commands. . . Intro(C) 

System commands, intro: Introduces XENIX Development . Intro(CP) 

development functions, intro: Introduction to DOS cross .... intro(DOS) 

intro: Introduction to file formats. . . . Intro(F) 

miscellaneous features/ intro: Introduction to machine related . . Intro(HW) 

features and files, intro: Introduction to miscellaneous . . Intro(M) 

be: Invokes a calculator bc(C) 

yacc: Invokes a compiler-compiler. . . . yacc(CP) 

bdos: Invokes a DOS system call. . . . bdos(DOS) 

intdos: Invokes a DOS system call. . . . intdos(DOS) 

intdosx: Invokes a DOS system call. . . . intdosx(DOS) 

debugger, adb: Invokes a general-purpose .... adb(CP) 

m4: Invokes a macro processor. . . . m4(CP) 

calendar: Invokes a reminder service. . . . calendar(C) 

(command interpreter), rsh: Invokes a restricted shell .... rsh(C) 

red: Invokes a restricted version of. . . red(C) 

display/ vi, view, vedit: Invokes a screen-oriented .... vi(C) 

interpreter with C-like/ csh: Invokes a shell command .... csh(C) 

ex: Invokes a text editor ex(C) 

calculator, dc: Invokes an arbitrary precision . . dc(C) 

restore, restor: Invokes incremental file system/ . restore(C) 

sdb: Invokes symbolic debugger. . . . sdb(CP) 

cc: Invokes the C compiler cc(CP) 

Id: Invokes the link editor ld(CP) 

Id: Invokes the link editor ld(M) 

interpreter, sh: Invokes the shell command . . . sh(C) 

sed: Invokes the stream editor sed(C) 
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ed: Invokes the text editor ed(C) 

masm: Invokes the XENIX assembler. . . masm(CP) 

shutdn: Flushes block I/O and halts the CPU shutdn(S) 

popen, pclose: Initiates I/O to or from a process popen(S) 

devices, ioctl: Controls character ioctl(S) 

abort: Generates an IOT fault abort(S) 

ips, isbs, ipbs: IMAGEN protocol handlers. . ips(ADM) 

semaphore set or shared memory, ipcrm: Removes a message queue, ipcrm(ADM) 

inter-process communication/ ipcs: Reports the status of .... ipcs(ADM) 

IMAGEN printer queue, ipr, oldipr: Put files onto the ... ipr(C) 

DVI format, iprint: Converts text files to ... iprint(C) 

packet protocol handler, ips: Imagen serial sequence . . . ips(ADM) 

handlers, ips, isbs, ipbs: IMAGEN protocol . ips(ADM) 

/islower, isdigit, isxdigit, isalnum, isspace, ispunct,/ .... ctype(S) 

isdigit, isxdigit,/ ctype, isalpha, isupper, islower, .... ctype(S) 

/isprint, isgraph, iscntrl, isascii, tolower, toupper,/ .... ctype(S) 

device, isatty: Checks for a character . . . isatty(DOS) 

terminal, ttyname, isatty: Finds the name of a .... ttyname(S) 

handlers, ips, isbs, ipbs: IMAGEN protocol . . . ips(ADM) 

/ispunct, isprint, isgraph, iscntrl, isascii, tolower,/ ctype(S) 

/isalpha, isupper, islower, isdigit, isxdigit, isalnum,/ .... ctype(S) 

/isspace, ispunct, isprint, isgraph, iscntrl, isascii,/ ctype(S) 

ctype, isalpha, isupper, islower, isdigit, isxdigit,/ .... ctype(S) 

/isalnum, isspace, ispunct, isprint, isgraph, iscntrl,/ ctype(S) 

/isxdigit, isalnum, isspace, ispunct, isprint, isgraph,/ .... ctype(S) 

/isdigit, isxdigit, isalnum, isspace, ispunct, isprint,/ .... ctype(S) 

isxdigit,/ ctype, isalpha, isupper, islower, isdigit, ctype(S) 

/isupper, islower, isdigit, isxdigit, isalnum, isspace,/ .... ctype(S) 

news: Print news items news(C) 

integers, itoa: Converts numbers to .... itoa(DOS) 

printer, itroff: Troff to an IMAGEN .... itroff(CT) 

Bessel functions, bessel, jO, jl,jn, yO, yl, yn: Performs . . bessel(S) 

Bessel functions, bessel, jO, jl,jn, yO, yl, yn: Performs .... bessel(S) 

functions, bessel, jO,jl, jn, yO, yl, yn: Performs Bessel . . bessel(S) 

join: Joins two relations join(C) 

join: Joins two relations. join(C) 

keystroke, kbhit: Checks the console for a . . kbhit(DOS) 

test keyboard support kbmode: Set keyboard mode or . . kbmode(ADM) 

error: Kernel error output device. . . . error(M) 

makekey: Generates an encryption key makekey(M) 

keyboard: The PC keyboard keyboard(HW) 

support kbmode: Set keyboard mode or test keyboard . kbmode(ADM) 

Set keyboard mode or test keyboard support kbmode: . . . kbmode(ADM) 

keyboard: The PC keyboard. . . . keyboard(HW) 

setkey: Assigns the function keys setkey(C) 

kbhit: Checks the console for a keystroke kbhit(DOS) 

usemouse: Maps mouse input to keystrokes usemouse(C) 

process or a group of/ kill: Sends a signal to a kill(S) 

kill: Terminates a process kill(C) 

mem, kmem: Memory image file. . . . mem(M) 

contents of directory. 1: Lists information about .... 1(C) 
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3-byte integers and long/ 13tol, ltol3: Converts between . . 13tol(S) 

integer and base 64/ a641, 164a: Converts between long . . . a641(S) 

of a long integer, labs: Returns the absolute value . . labs(DOS) 

cpp: The C language preprocessor cpp(CP) 

lint: Checks C language usage and syntax. • . . lint(CP) 

diction: Checks language usage diction(CT) 

explain: Corrects language usage explain(CT) 

shl: Shell layer manager shl(C) 

columns, lc: Lists directory contents in . . . lc(C) 

distributed. srand48, seed48, lcong48: Generates uniformly . . drand48(S) 

Id: Invokes the link editor ld(CP) 

Id: Invokes the link editor ld(M) 

floating-point number/ frexp, ldexp, modf: Splits frexp(S) 

filelength: Gets the length of a file fileleng(DOS) 

strlen: Returns the length of a string strlen(DOS) 

getopt: Gets option letter from argument vector. . . . getopt(S) 

banner: Prints large letters banner(C) 

lexical analysis, lex: Generates programs for ... lex(CP) 

lex: Generates programs for lexical analysis lex(CP) 

and update, lsearch, lfind: Performs linear search . . . lsearch(S) 

ar: Maintains archives and libraries ar(CP) 

Converts archives to random libraries, ranlib: ranlib(CP) 

/Introduces system services, library routines and error/ .... Intro(S) 

ordering relation for an object library, lorder: Finds lorder(CP) 

ulimit: Gets and sets user limits ulimit(S) 

line: Reads one line line(C) 

lsearch, lfind: Performs linear search and update lsearch(S) 

col: Filters reverse linefeeds col(CT) 

lpr: Sends files to the lineprinter queue for printing. . . lpr(C) 

lpshut, lpmove: Starts/stops the lineprinter request, lpsched, . . . lpsched(ADM) 

lpadmin: Configures the lineprinter spooling system. . . . lpadmin(ADM) 

lpstat: prints lineprinter status information. . . lpstat(C) 

cancel: Send/cancel requests to lineprinter. lp, lpr, lp(C) 

Adds, reconfigures and maintains lineprinters. Ipinit: lpinit(ADM) 

files, comm: Selects or rejects lines common to two sorted . . . comm(C) 

uniq: Reports repeated lines in a file uniq(C) 

look: Finds lines in a sorted list look(CT) 

head: Prints the first few lines of a stream head(C) 

paste: Merges lines of files paste(CT) 

wc: Counts lines, words and characters. . . . wc(C) 

Id: Invokes the link editor ld(CP) 

Id: Invokes the link editor ld(M) 

a.out: Format of assembler and link editor output a.out(F) 

existing file, link: Links a new filename to an . link(S) 

In: Makes a link to a file ln(C) 

dosld: XENIX to MS-DOS cross linker dosld(CP) 

existing file, link: Links a new filename to an .... link(S) 

and syntax, lint: Checks C language usage . . lint(CP) 

xlist, fxlist: Gets name list entries from files xlist(S) 

look: Finds lines in a sorted list look(CT) 

nlist: Gets entries from name list nlist(S) 
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nm: Prints name list nm(CP) 

by fsck. checklist: List of file systems processed . . . checklist(F) 

terminals: List of supported terminals. . . . terminals(M) 

varargs: variable argument list varargs(S) 

cref: Makes a cross-reference listing cref(CP) 

of a varargs argument list. /Prints formatted output . . . vprintf(S) 

columns, lc: Lists directory contents in .... lc(C) 

of directory. 1: Lists information about contents . 1(C) 

who: Lists who is on the system who(C) 

In: Makes a link to a file ln(C) 

tzset: Converts date and/ ctime, localtime, gmtime, asctime, . . . ctime(S) 

end, etext, edata: Last locations in program end(S) 

memory, lock: Locks a process in primary . lock(S) 

lock: Locks a user's terminal. . . lock(C) 

memory, plock: Lock process, text, or data in . . . plock(S) 

record locking on files, lockf: Provide semaphores and . . lockf(S) 

region for reading or writing, locking: Locks or unlocks a file . . locking(S) 

Provide semaphores and record locking on files, lockf: lockf(S) 

memory, lock: Locks a process in primary . . . lock(S) 

lock: Locks a user's terminal lock(C) 

for reading or/ locking: Locks or unlocks a file region . . locking(S) 

gamma: Performs log gamma function gamma(S) 

exponential, logarithm,/ exp, log, pow, sqrt, loglO: Performs . . exp(S) 

logarithm,/ exp, log, pow, sqrt, loglO: Performs exponential, . . . exp(S) 

/loglO: Performs exponential, logarithm, power, square root/ . . exp(S) 

mkuser: Adds a login ID to the system mkuser(ADM) 

getlogin: Gets login name getlogin(S) 

logname: Gets login name logname(C) 

cuserid: Gets the login name of the user cuserid(S) 

logname: Finds login name of user logname(S) 

passwd: Changes login password passwd(C) 

chsh: changes user login shell in password file. . . . chsh(ADM) 

terminal: Login terminal terminal(HW) 

inittab: Alternative login terminals file inittab(F) 

ttys: Login terminals file ttys(F) 

Sets up an environment at login time, profile: profile(M) 

last: Indicate last logins of users and teletypes . . . last(C) 

user, logname: Finds login name of . . logname(S) 

logname: Gets login name. . . . . logname(C) 

idleout: Logs out idle users idleout(ADM) 

newgrp: Logs user into a new group. . . . newgrp(C) 

"goto", setjmp, longjmp: Performs a nonlocal . . setjmp(S) 

for an object library, lorder: Finds ordering relation . . lorder(CP) 

uppercase, strupr: Converts lowercase characters to strupr(DOS) 

Converts uppercase characters to lowercase, strlwr: strlwr(DOS) 

device interfaces, lp, lpO, lpl, lp2: Line printer . . . lp(HW) 

requests to lineprinter. lp, lpr, cancel: Send/cancel . . . lp(C) 

device interfaces, lp, lpO, lpl, lp2: Line printer .... lp(HW) 

interfaces, lp, lpO, lpl, lp2: Line printer device . . . lp(HW) 

interfaces, lp, lpO, lpl, lp2: Line printer device lp(HW) 

lineprinter spooling system, lpadmin: Configures the lpadmin(ADM) 
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maintains lineprinters. lpinit: Adds, reconfigures and . . lpinit(ADM) 

lineprinter/ lpsched, lpshut, lpmove: Starts/stops the lpsched(ADM) 

requests to lineprinter. lp, lpr, cancel: Send/cancel lp(C) 

lineprinter queue for printing, lpr: Sends files to the lpr(C) 

attached to the user's terminal lprint: Print to a printer lprint(C) 

Starts/stops the lineprinter/ lpsched, lpshut, lpmove: Ipsched(ADM) 

lineprinter request, lpsched, lpshut, lpmove: Starts/stops the . . lpsched(ADM) 

status information, lpstat: prints lineprinter lpstat(C) 

contents of directories. Is: Gives information about . . . ls(C) 

search and update, lsearch, lfind: Performs linear . . lsearch(S) 

pointer, lseek: Moves read/write file ... lseek(S) 

characters, ltoa: Converts long integers to . . ltoa(DOS) 

integers and long/ 13tol, ltol3: Converts between 3-byte . . 13tol(S) 

m4: Invokes a macro processor. . . m4(CP) 

machine. Machine: Description of host . . . machine(HW) 

Machine: Description of host machine machine(HW) 

features/ intro: Introduction to machine related miscellaneous . . Intro(HW) 

Accesses long integer data in a machine-independent, /sgetl: . . sputl(S) 

m4: Invokes a macro processor m4(CP) 

mmcheck: Checks usage of MM macros, checkmm, checkmm(CT) 

formatted with the mm macros, mm: Prints documents . . mm(CT) 

program, tape: Magnetic tape maintenance . . . tape(C) 

tapedump: Dumps magnetic tape to output file. . . . tapedump(C) 

of mail, mail: Sends, reads or disposes . . mail(C) 

daemon.mn: Micnet mailer daemon daemon.mn(M) 

Sends, reads or disposes of mail, mail: mail(C) 

binary file for transmission via mail uudecode: decode a .... uuencode(C) 

binary file for transmission via mail uuencode: encode a .... uuencode(C) 

free, realloc, calloc: Allocates main memory, malloc, malloc(S) 

fdisk: Maintain disk partitions fdisk(ADM) 

libraries, ar: Maintains archives and ar(CP) 

lpinit: Adds, reconfigures and maintains lineprinters lpinit(ADM) 

regenerates groups of/ make: Maintains, updates, and make(CP) 

systty: System maintenance device systty(M) 

tape: Magnetic tape maintenance program tape(C) 

key. makekey: Generates an encryption makekey(M) 

cref: Makes a cross-reference listing. . . cref(CP) 

execseg: makes a data region executable. . execseg(S) 

SCCS file, delta: Makes a delta (change) to an ... delta(CP) 

mkdir: Makes a directory mkdir(C) 

or ordinary file, mknod: Makes a directory, or a special . . mknod(S) 

In: Makes a link to a file ln(C) 

mktemp: Makes a unique filename mktemp(S) 

another user, su: Makes the user a super-user or . . su(C) 

Allocates main memory, malloc, free, realloc, calloc: . . . malloc(S) 

shl: Shell layer manager shl(C) 

tsearch, tfind, tdelete, twalk: Manages binary search trees. . . . tsearch(S) 

hsearch, hcreate, hdestroy: Manages hash search tables. . . . hsearch(S) 

/floating-point number into a mantissa and an exponent frexp(S) 

ascii: Map of the ASCII character set. . . ascii(M) 

mapping, mapchan: Configure tty device . . mapchan(M) 
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mapping files, mapchan: Format of tty device . . mapchan(F) 

convkey: Configure monitor/ mapkey, mapscrn, mapstr, .... mapkey(M) 

mapchan: Format of tty device mapping files mapchan(F) 

mapchan: Configure tty device mapping mapchan(M) 

Configure monitor screen mapping, /mapstr, convkey: . . . mapkey (M) 

usemouse: Maps mouse input to keystrokes . usemouse(C) 

Configure monitor/ mapkey, mapscrn, mapstr, convkey: .... mapkey(M) 

monitor screen/ mapkey, mapscrn, mapstr, convkey: Configure . . . mapkey (M) 

diffmk: Marks differences between files. . diffmk(CT) 

umask: Sets file-creation mode mask '. umask(C) 

Sets and gets file creation mask, umask: umask(S) 

assembler, masm: Invokes the XENIX . . . masm(CP) 

master: Master device information table. . master(F) 

information table, master: Master device master(F) 

Regular expression compile and match routines, regexp: regexp(S) 

/heqn, checkeq, eqncheck: Formats mathematical text for nroff,/ . . . eqn(CT) 

neqn: Formats mathematics neqn(CT) 

function, matherr: Error-handling matherr(S) 

mem, kmem: Memory image file. . mem(M) 

mem, kmem: Memory image file mem(M) 

lock: Locks a process in primary memory lock(S) 

shmctl: Controls shared memory operations shmctl(S) 

shmop: Performs shared memory operations shmop(S) 

shmget: Gets a shared memory segment shmget(S) 

Reports virtual memory statistics, vmstat: .... vmstat(C) 

realloc, calloc: Allocates main memory, malloc, free, malloc(S) 

Lock process, text, or data in memory, plock: plock(S) 

queue, semaphore set or shared memory. /Removes a message . . ipcrm(ADM) 

administration/ sysadmsh: Menu driven system sysadmsh(ADM) 

sort: Sorts and merges files sort(C) 

paste: Merges lines of files paste(CT) 

sent to a terminal, mesg: Permits or denies messages . mesg(C) 

msgctl: Provides message control operations. . . . msgctl(S) 

mkstr: Creates an error message file from C source. . . . mkstr(CP) 

msgop: Message operations msgop(S) 

msgget: Gets message queue msgget(S) 

shared memory, ipcrm: Removes a message queue, semaphore set or . ipcrm(ADM) 

hello: Send a message to another user hello(ADM) 

console messages, messages: Description of system . messages(M) 

dosexterr: Gets DOS error messages dosexter(DOS) 

mesg: Permits or denies messages sent to a terminal. . . . mesg(C) 

Description of system console messages, messages: messages(M) 

errno: Sends system error messages. /sys_nerr, perror(S) 

telinit, mkinittab: Alternative method of turning terminals on/ . . telinit(ADM) 

generator, aliashash: Micnet alias hash table aliashash(ADM) 

faliases: Micnet aliasing files aliases(M) 

micnet: The Micnet default commands file. . . micnet(F) 

daemon.mn: Micnet mailer daemon daemon.mn(M) 

file, systemid: The Micnet system identification . . . systemid(F) 

commands file, micnet: The Micnet default . . . micnet(F) 

top, top.next: The Micnet topology files top(F) 
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/Introduction to machine related miscellaneous features and/ . . . Intro(HW) 

files, intro: Introduction to miscellaneous features and . . . Intro(M) 

mkdir: Creates a new directory. . . mkdir(DOS) 

mkdir: Makes a directory mkdir(C) 

mkfs: Constructs a file system. . . mkfs(ADM) 

turning terminals on/ telinit, mkinittab: Alternative method of . telinit(ADM) 

mknod: Builds special files. . . . mknod(C) 

special or ordinary file, mknod: Makes a directory, or a . . mknod(S) 

file from C source, mkstr: Creates an error message . mkstr(CP) 

mktemp: Makes a unique filename. mktemp(S) 

system, mkuser: Adds a login ID to the . . mkuser(ADM) 

mmcheck: Checks usage of MM macros, checkmm, checkmm(CT) 

with the mm macros, mm: Prints documents formatted . mm(CT) 

macros, checkmm, mmcheck: Checks usage of MM . checkmm(CT) 

mmt: Typesets documents mmt(CT) 

mnt: Mount a filesystem mnt(C) 

system table, mnttab: Format of mounted file . . mnttab(F) 

vidi: Sets the font andjvideo mode for a video device vidi(C) 

umask: Sets file-creation mode mask umask(C) 

chmod: Changes mode of a file chmod(S) 

kbmode: Set keyboard mode or test keyboard support . . kbmode(ADM) 

setmode: Sets translation mode setmode(DOS) 

dial: Dials a modem dial(ADM) 

uuchat: dials a modem dial(ADM) 

getty: Sets terminal type, modes, speed, and line/ getty(M) 

tset: Sets terminal modes tset(C) 

number into a/ frexp, ldexp, modf: Splits floating-point .... frexp(S) 

settime: Changes the access and modification dates of files settime(ADM) 

touch: Updates access and modification times of a file. . . . touch(C) 

utime: Sets file access and modification times utime(S) 

Relocatable Format for Object Modules. 86rel: Intel 8086 . . . 86rel(F) 

profile, monitor: Prepares execution . . . monitor(S) 

/mapstr, convkey: Configure monitor screen mapping mapkey(M) 

uusub: Monitor uucp network uusub(C) 

tty[01-rt], color, monochrome, ega,. screen: . . . screen(HW) 

mnt: Mount a filesystem mnt(C) 

fstab: File system mount and check commands. . . . fstab(F) 

mount: Mounts a file structure. . . mount(ADM) 

mount: Mounts a file system. . . . mount(S) 

mnttab: Format of mounted file system table mnttab(F) 

/Default information for mounting filesystems filesys(F) 

mount: Mounts a file structure mount(ADM) 

mount: Mounts a file system mount(S) 

usemouse: Maps mouse input to keystrokes .... usemouse(C) 

mouse: System mouse mouse(HW) 

mouse: System mouse mouse(HW) 

specific address, movedata: Copies bytes from a . . movedata(DOS) 

mvdir: Moves a directory mvdir(C) 

directories, mv: Moves or renames files and . . . mv(C) 

lseek: Moves read/write file pointer. . . lseek(S) 

utility mscreen: Serial multiscreens . . . mscreen(M) 



1-34 



Permuted Index 



dosld: XENIX to MS-DOS cross linker dosld(CP) 

operations, msgctl: Provides message control . msgctl(S) 

msgget: Gets message queue. . . . msgget(S) 

msgop: Message operations. . . . msgop(S) 

mscreen: Serial multiscreens utility mscreen(M) 

directories, mv: Moves or renames files and . . mv(C) 

mvdir: Moves a directory mvdir(C) 

devnm: Identifies device name devnm(C) 

getlogin: Gets login name getlogin(S) 

logname: Gets login name logname(C) 

pwd: Prints working directory name pwd(C) 

tty: Gets the terminal's name tty(C) 

Gets value for environment name, getenv: getenv(S) 

ncheck: Generates names from inode numbers. . . . ncheck(ADM) 

basename: Removes directory names from pathnames basename(C) 

archive, dumpdir: Prints the names of files on a backup .... dumpdir(C) 

term: Conventional names term(CT) 

Prints user and group IDs and names, id: id(C) 

short interval, nap: Suspends execution for a . . nap(S) 

access to a resource/ waitsem, nbwaitsem: Awaits and checks . . waitsem(S) 

inode numbers, ncheck: Generates names from . . ncheck(ADM) 

mathematical text for/ eqn, neqn, checkeq, eqncheck: Formats eqn(CT) 

neqn: Formats mathematics. . . . neqn(CT) 

network, netutil: Administers the XEMX . . netutil(ADM) 

netutil: Administers the XEMX network netutil(ADM) 

uusub: Monitor uucp network uusub(C) 

text file, newform: Changes the format of a . newform(C) 

group, newgrp: Logs user into a new . . newgrp(C) 

news: Print news items news(C) 

news: Print news items news(C) 

/fetch, store, delete, firstkey, nextkey: Performs database/ . . . dbm(S) 

process, nice: Changes priority of a .... nice(S) 

different priority, nice: Runs a command at a ... nice(C) 

nl: Adds line numbers to a file. . . nl(C) 

list, nlist: Gets entries from name . . . nlist(S) 

nm: Prints name list nm(CP) 

hangups and quits, nohup: Runs a command immune to nohup(C) 

setjmp, longjmp: Performs a nonlocal "goto" setjmp(S) 

false: Returns with a nonzero exit value false(C) 

nroff: A text formatter nrofl^CT) 

soelim: Eliminates .so's from nroff input soelim(CT) 

tbl: Formats tables for nroff or troff. tbl(CT) 

Formats mathematical text for nroff, troff. /eqncheck: eqn(CT) 

Terminal driving tables for nroff. term: term(F) 

constructs, deroffi Removes nroff/troff, tbl, and eqn deroff(CT) 

null: The null file null(F) 

null: The null file null(F) 

factor: Factor a number factor(C) 

random: Generates a random number random(C) 

rand, srand: Generates a random number rand(S) 

nl: Adds line numbers to a file nl(C) 
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ultoa: Converts numbers to characters ultoa(DOS) 

itoa: Converts numbers to integers itoa(DOS) 

atoi, atol: Converts ASCII to numbers, atof, atof(S) 

Generates names from inode numbers, ncheck: ncheck(ADM) 

library routines and error numbers, /system services, . . . Intro(S) 

a string to a double-precision number, strtod, atof: Converts . . strtod(S) 

size: Prints the size of an object file size(CP) 

the printable strings in an object file, strings: Finds .... strings(CP) 

Finds ordering relation for an object library, lorder: lorder(CP) 

8086 Relocatable Format for Object Modules. 86rel: Intel . . . 86rel(F) 

a process until a signal occurs, pause: Suspends .... pause(S) 

od: Displays files in octal format od(C) 

format, od: Displays files in octal .... od(C) 

of turning terminals on and off. /Alternative method telinit(ADM) 

fp_off, fp_seg: Return offset and segment fp_seg(DOS) 

Invokes a restricted version of. red: red(C) 

IMAGEN printer queue, ipr, oldipr: Put files onto the ipr(C) 

new file or rewrites an existing one. creat: Creates a creat(S) 

ipr, oldipr: Put files onto the IMAGEN printer queue. . ipr(C) 

and writing, sopen: Opens a file for shared reading . . sopen(DOS) 

opensem: Opens a semaphore opensem(S) 

fopen, freopen, fdopen: Opens a stream fopen(S) 

writing, open: Opens file for reading or open(S) 

opensem: Opens a semaphore. . . opensem(S) 

closedir: Performs directory operations directory(S) 

msgctl: Provides message control operations msgctl(S) 

msgop: Message operations msgop(S) 

semctl: Controls semaphore operations semctl(S) 

semop: Performs semaphore operations semop(S) 

shmctl: Controls shared memory operations shmctl(S) 

shmop: Performs shared memory operations shmop(S) 

strdup: Performs string operations string(S) 

vector, getopt: Gets option letter from argument . . . getopt(S) 

stty: Sets the options for a terminal stty(C) 

getopt: Parses command options getopt(C) 

library, lorder: Finds ordering relation for an object . . lorder(CP) 

a directory, or a special or ordinary file, mknod: Makes . . . mknod(S) 

Copies file archives in and out. cpio: cpio(C) 

dial: Establishes an out-going terminal line/ dial(S) 

port, outp: Writes a byte to an output . . outp(DOS) 

flushall: Flushes all output buffers flushall(DOS) 

ecvt, fcvt, gcvt: Performs output conversions. ...... ecvt(S) 

cprintf: Formats output cprintf(DOS) 

error: Kernel error output device error(M) 

tapedump: Dumps magnetic tape to output file tapedump(C) 

/vsprintf: Prints formatted output of a varargs/ vprintf(S) 

outp: Writes a byte to an output port outp(DOS) 

pr: Prints files on the standard output pr(C) 

of assembler and link editor output. a.out: Format a.out(F) 

buffered binary input and output, fread, fwrite: Performs . . fread(S) 

fprintf, sprintf: Formats output, printf printf(S) 
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standard buffered input and output, stdio: Performs stdio(S) 

chown: Changes the owner and group of a file chown(S) 

chown: Changes owner ID chown(C) 

quot: Summarizes file system ownership quot(C) 

and expands files, pack, peat, unpack: Compresses . pack(C) 

interprocess communication package, ftok: Standard stdipc(S) 

ips: Imagen serial sequence packet protocol handler ips(ADM) 

Gets process, process group, and parent process IDs. /getppid: . . • getpid(S) 

getopt: Parses command options getopt(C) 

fdisk: Maintain disk partitions fdisk(ADM) 

files, hdr: Displays selected parts of executable binary .... hdr(CP) 

passwd: Changes login password. . passwd(C) 

passwd: The password file. . . . passwd(F) 

pwadmin: Performs password aging administration. . . pwadmin(ADM) 

putpwent: Writes a password file entry putpwent(S) 

setpwent, endpwent: Gets password file entry, /getpwnam, . getpwent(S) 

passwd: The password file passwd(F) 

pwcheck: Checks password file pwcheck(C) 

changes user login shell in password file, chsh: chsh(ADM) 

getpw: Gets password for a given user ID. . . . getpw(S) 

getpass: Reads a password getpass(S) 

passwd: Changes login password passwd(C) 

paste: Merges lines of files. . . . paste(CT) 

directory, getcwd: Get the pathname of current working . . . getcwd(S) 

Delivers directory part of pathname, dirname: dirname(C) 

Removes directory names from pathnames, basename: basename(C) 

Searches for and processes a pattern in a file, awk: awk(C) 

fgrep: Searches a file for a pattern, grep, egrep, grep(C) 

a signal occurs, pause: Suspends a process until . . pause(S) 

keyboard: The PC keyboard keyboard(HW) 

expands files, pack, peat, unpack: Compresses and . . pack(C) 

a process, popen, pclose: Initiates I/O to or from . . popen(S) 

bsearch: Performs a binary search bsearch(S) 

setjmp, longjmp: Performs a nonlocal "goto". . . . setjmp(S) 

qsort: Performs a quicker sort qsort(S) 

floor, fabs, ceil, fmod: Performs absolute value, floor,/ . . fioor(S) 

bessel, jO, jl, jn, yO, yl, yn: Performs Bessel functions bessel(S) 

and output, fread, fwrite: Performs buffered binary input . . fread(S) 

/delete, firstkey, nextkey: Performs database functions. . . . dbm(S) 

closedir: Performs directory operations. . . directory(S) 

exp, log, pow, sqrt, log 10: Performs exponential, logarithm,/ . exp(S) 

restores files, sysadmin: Performs file system backups and . sysadmin(ADM) 

sinh, cosh, tanh: Performs hyperbolic functions. . . sinh(S) 

backup, backup: Performs incremental file system . backup(C) 

backup, dump: Performs incremental file system . dump(C) 

update, lsearch, lfind: Performs linear search and .... lsearch(S) 

gamma: Performs log gamma function. . . gamma(S) 

ecvt, fevt, gcvt: Performs output conversions. . . . ecvt(S) 

administration, pwadmin: Performs password aging .... pwadmin(ADM) 

system backups fsphoto: Performs periodic semi-automated . fsphoto(ADM) 

functions, curses: Performs screen and cursor . . . curses(S) 
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semop: Performs semaphore operations. . semop(S) 

operations, shmop: Performs shared memory .... shmop(S) 

and output, stdio: Performs standard buffered input . stdio(S) 

strdup: Performs string operations. .... string(S) 

Agetflag, tgetstr, tgoto, tputs: Performs terminal functions. . . . termcap(S) 

tan, asin, acos, atan, atan2: Performs trigonometric/ /cos, . . trig(S) 

backups fsphoto: Performs periodic semi-automated system . fsphoto(ADM) 

check the uucp directories and permissions file uucheck: .... uucheck(ADM) 

chmod: Changes the access permissions of a file or/ chmod(C) 

to a terminal, mesg: Permits or denies messages sent . mesg(C) 

ptx: Generates a permuted index ptx(CT) 

acct: Format of per-process accounting file. . . . acct(F) 

errno: Sends system error/ perror, sys_errlist, sysjnerr, . . . perror(S) 

split: Splits a file into pieces split(C) 

pipe, pipe: Creates an interprocess . . . pipe(S) 

pipe: Creates an interprocess pipe pipe(S) 

tee: Creates a tee in a pipe tee(C) 

data in memory, plock: Lock process, text, or ... plock(S) 

rewind: Repositions a file pointer in a stream, /ftell, .... fseek(S) 

lseek: Moves read/write file pointer lseek(S) 

the current position of the file pointer, tell: Gets tell(DOS) 

or from a process, popen, pclose: Initiates I/O to . . popen(S) 

outp: Writes a byte to an output port outp(DOS) 

,tty2[A-H]: Interface to serial ports. /, ttyl[A-H] , tty2[a-h] . . . serial(HW) 

exponential,/ exp, log, pow, sqrt, log 10: Performs .... exp(S) 

/Performs exponential, logarithm, power, square root functions. . . . exp(S) 

output, pr: Prints files on the standard . . pr(C) 

dc: Invokes an arbitrary precision calculator dc(C) 

statistical processing, prep: Prepares text for prep(CT) 

troff. cw, checkcw, cwcheck: Prepares constant- width text for . . cw(CT) 

monitor: Prepares execution profile monitor(S) 

processing, prep: Prepares text for statistical .... prep(CT) 

cpp: The C language preprocessor cpp(CP) 

unget: Undoes a previous get of an SCCS file. . . . unget(CP) 

lock: Locks a process in primary memory lock(S) 

types: Primitive system data types. . . . types(F) 

to a serial/ consoleprint: Print file to printer attached . . . consoleprint(ADM) 

news: Print news items news(C) 

printer, imprint: print text files on an IMAGEN . . imprint(CT) 

the user's terminal lprint: Print to a printer attached to ... lprint(C) 

file, strings: Finds the printable strings in an object . . . strings(CP) 

consoleprint: Print file to printer attached to a serial/ .... consoleprint(ADM) 

terminal lprint: Print to a printer attached to the user's . . . lprint(C) 

lp, lpO, lpl, lp2: Line printer device interfaces lp(HW) 

/imagen.remote: IMAGEN printer interface scripts imagen(M) 

itroff: Troff to an IMAGEN printer itroff(CT) 

Put files onto the IMAGEN printer queue, ipr, oldipr: .... ipr(C) 

Prints text files on an IMAGEN printer, imprint: imprint(C) 

print text files on an IMAGEN printer, imprint: imprint(CT) 

disable: Turns off terminals and printers disable(C) 

Turns on terminals and line printers, enable: enable(C) 
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Formats output, 
to the lineprinter queue for 
cal: 
prs: 
sddate: 
date: 
activity, sact: 
the mm macros, mm: 
output, pr: 
vprintf, vfprintf, vsprintf: 
banner: 
information, lpstat: 
nm: 

acctcom: Searches for and 
yes: 

printer, imprint: 
stream, head: 
XENIX system, uname: 
backup archive, dumpdir: 
file, size: 
names, id: 
pwd: 
nice: Changes 
Runs a command at a different 
acct: Enables or disables 
acctcom: Searches for and prints 
alarm: Sets a 
times: Gejts 
init, inir: 

exit: Terminates the calling 
exit, _exit: Terminates a 
fork: Creates a new 
/getpgrp, getppid: Gets process, 
setpgrp: Sets 
process group, and parent 
lock: Locks a 
kill: Terminates a 
nice: Changes priority of a 
kill: Sends a signal to a 
getpid, getpgrp, getppid: Gets 
ptrace: Traces a 
spawnl, spawnvp: Creates a new 
ps: Reports 
memory. plock:Lock 
times: Gets process and child 
wait: Waits for a child 
pause: Suspends a 
sigsem: Signals a 
checklist: List of file systems 
awk: Searches for and 
to a process or a group of 





. printf(S) 


printing, lpr: Sends files . . . 


. lpr(C) 




. cal(C) 


Prints an SCCS file 


. prs(CP) 


Prints and sets backup dates. . . 


. sddate(C) 




. date(C) 


Prints current SCCS file editing . 


. sact(CP) 


Prints documents formatted with 


. mm(CT) 


Prints files on the standard . . . 


. pr(C) 


Prints formatted output of a/ 


. vprintf(S) 




. banner(C) 




. lpstat(C) 




nm(CP) 


prints process accounting files. 


. acctcom(ADM) 




. yes(C) 


Prints text files on an IMAGEN . 


. imprint(C) 


Prints the first few lines of a 


. head(C) 


Prints the name of the current 


. uname(C) 


Prints the names of files on a . . 


. dumpdir(C) 


Prints the size of an object . . . 


. size(CP) 


Prints user and group IDs and 


. id(C) 


Prints working directory name. 


. pwd(C) 




. nice(S) 




. nice(C) 




. acct(S) 


process accounting files. . . . 


. acctcom(ADM) 




. alarm(S) 


process and child process times. 


. times(S) 


Process control initialization. . . 


. init(M) 




. exit(DOS) 




. exit(S) 




. fork(S) 


process group, and parent/ . . . 


. getpid(S) 




. setpgrp(S) 


process IDs. /Gets process, . . 


. getpid(S) 


process in primary memory. . . 


. lock(S) 




. kill(C) 




. nice(S) 


process or a group of processes. . 


. kill(S) 


process, process group, and/ . . 


. getpid(S) 




. ptrace(S) 




. spawn(DOS) 




. ps(C) 




. plock(S) 




. times(S) 


process to stop or terminate. . . 


. wait(S) 


process until a signal occurs. . . 


. pause(S) 


process waiting on a semaphore. 


. sigsem(S) 




. checklist(F) 


processes a pattern in a file. . . 


. awk(C) 


processes, kill: Sends a signal 


. kill(S) 
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Awaits completion of background processes, wait: wait(C) 

intro: Introduces text processing commands Intro(CT) 

shutdown: Terminates all processing shutdown(ADM) 

Prepares text for statistical processing, prep: prep(CT) 

m4: Invokes a macro processor m4(CP) 

Initiates I/O to or from a process, popen, pclose: popen(S) 

prof: Displays profile data prof(CP) 

time profile, profil: Creates an execution . . . profil(S) 

prof: Displays profile data prof (CP) 

monitor: Prepares execution profile monitor(S) 

at login time, profile: Sets up an environment . . profile(M) 

Creates an execution time profile, profil: profil(S) 

assert: Helps verify validity of program assert(S) 

boot: XENIX boot program boot(HW) 

tape: Magnetic tape maintenance program tape(C) 

etext, edata: Last locations in program, end, end(S) 

cb: Beautifies C programs cb(CP) 

lex: Generates programs for lexical analysis. . . lex(CP) 

xref: Cross-references C programs xref(CP) 

xstr: Extracts strings from C programs xstr(CP) 

and regenerates groups of programs. /Maintains, updates, . . make(CP) 

stack requirements for C programs, stackuse: Determines . stackuse(CP) 

day. asktime: Prompts for the correct time of . . asktime(ADM) 

Imagen serial sequence packet protocol handler, ips: ips(ADM) 

ips, isbs, ipbs: IMAGEN protocol handlers ips(ADM) 

locking on files, lockf: Provide semaphores and record . . lockf(S) 

operations, msgctl: Provides message control .... msgctl(S) 

prs: Prints an SCCS file prs(CP) 

ps: Reports process status ps(C) 

sxt: Pseudo-device driver sxt(M) 

information, pstat: Reports system pstat(C) 

ptrace: Traces a process ptrace(S) 

ptx: Generates a permuted index. . ptx(CT) 

stream, ungetc: Pushes character back into input . ungetc(S) 

a character or word on a/ putc, putchar, fputc, putw: Puts . . putc(S) 

console, putch: Writes a character to the . . putch(DOS) 

character or word on a/ putc, putchar, fputc, putw: Puts a ... putc(S) 

environment, putenv: Changes or adds value to . putenv(S) 

entry, putpwent: Writes a password file . putpwent(S) 

putc, putchar, fputc, putw: Puts a character or word on a/ . . putc(S) 

puts, fputs: Puts a string on a stream puts(S) 

cputs: Puts a string to the console. . . . cputs(DOS) 

stream, puts, fputs: Puts a string on a ... puts(S) 

on a/ putc, putchar, fputc, putw: Puts a character or word . . putc(S) 

administration, pwadmin: Performs password aging pwadmin(ADM) 

pwcheck: Checks password file. . pwcheck(C) 

name, pwd: Prints working directory . . pwd(C) 

qsort: Performs a quicker sort. . . qsort(S) 

tput: Queries the terminfo database. . . tput(C) 

Sends files to the lineprinter queue for printing. Ipr: lpr(C) 

msgget: Gets message queue msgget(S) 
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ipcrm: Removes a message queue, semaphore set or shared/ . ipcrm(ADM) 

files onto the IMAGEN printer queue, ipr, oldipr: Put ipr(C) 

qsort: Performs a quicker sort qsort(S) 

a command immune to hangups and quits, nohup: Runs nohup(C) 

ownership, quot: Summarizes file system . . . quot(C) 

number, rand, srand: Generates a random . rand(S) 

number, random: Generates a random . . . random(C) 

ranlib: Converts archives to random libraries ranlib(CP) 

random: Generates a random number random(C) 

rand, srand: Generates a random number rand(S) 

random libraries, ranlib: Converts archives to ... ranlib(CP) 

FORTRAN into standard FORTRAN, ratfor: Converts Rational .... ratfor(CP) 

FORTRAN, ratfor: Converts Rational FORTRAN into standard . ratfor(CP) 

systems, rep: Copies files across XENIX . . rcp(C) 

data to be read, rdchk: Checks to see if there is . . rdchk(S) 

read: Reads from a file read(S) 

information, hwconfig: Read the configuration hwconfig(ADM) 

sopen: Opens a file for shared reading and writing sopen(DOS) 

open: Opens file for reading or writing open(S) 

or unlocks a file region for reading or writing. /Locks .... locking(S) 

to see if there is data to be read, rdchk: Checks rdchk(S) 

getpass: Reads a password getpass(S) 

defopen, defread: Reads default entries defopen(S) 

read: Reads from a file read(S) 

line: Reads one line line(C) 

mail: Sends, reads or disposes of mail mail(C) 

lseek: Moves read/write file pointer lseek(S) 

memory, malloc, free, realloc, calloc: Allocates main . . malloc(S) 

clock: The system real-time (time of day) clock. . . . clock(F) 

setclock: Sets the system real-time (time of day) clock. . . . setclock(ADM) 

systems and shuts down/ haltsys, reboot: Closes out the file .... haltsys(ADM) 

Specifies what to do upon receipt of a signal, signal: .... signal(S) 

lineprinters. lpinit: Adds, reconfigures and maintains .... lpinit(ADM) 

lockf: Provide semaphores and record locking on files lockf(S) 

version of. red: Invokes a restricted red(C) 

regular expressions, regex, regemp: Compiles and executes . . regex(S) 

expressions, regemp: Compiles regular .... regcmp(CP) 

make: Maintains, updates, and regenerates groups of programs. . make(CP) 

executes regular expressions, regex, regemp: Compiles and . . . regex(S) 

compile and match routines, regexp: Regular expression . . . regexp(S) 

execseg: makes a data region executable execseg(S) 

locking: Locks or unlocks a file region for reading or writing. . . . locking(S) 

match routines, regexp: Regular expression compile and . regexp(S) 

regemp: Compiles regular expressions regcmp(CP) 

regemp: Compiles and executes regular expressions, regex, . . . regex(S) 

sorted files, comm: Selects or rejects lines common to two . . . comm(C) 

intro: Introduction to machine related miscellaneous features/ . . Intro(HW) 

lorder: Finds ordering relation for an object library. . . . lorder(CP) 

join: Joins two relations join(C) 

Modules. 86rel: Intel 8086 Relocatable Format for Object . . 86rel(F) 

strip: Removes symbols and relocation bits strip(CP) 
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value, floor, ceiling and remainder functions, /absolute . . floor(S) 

calendar: Invokes a reminder service calendar(C) 

remote XENIX system, remote: Executes commands on a . remote(C) 

uutry: try to contact remote system with debugging on . uutry(ADM) 

ct: spawn getty to a remote terminal ct(C) 

remote: Executes commands on a remote XENIX system remote(C) 

uux: Executes command on remote XENIX uux(C) 

file, rmdel: Removes a delta from an SCCS . . rmdel(CP) 

semaphore set or shared/ ipcrm: Removes a message queue, . . . ipcrm(ADM) 

system, rmuser: Removes a user account from the . rmuser(ADM) 

rmdir: Removes directories rmdir(C) 

unlink: Removes directory entry unlink(S) 

pathnames, basename: Removes directory names from . . basename(C) 

rm, rmdir: Removes files or directories. . . . rm(C) 

eqn constructs, deroff: Removes nroff/troff, tbl, and . . . derofiXCT) 

bits, strip: Removes symbols and relocation . strip(CP) 

directory, rename: renames a file or .... rename(DOS) 

rename: renames a file or directory rename(DOS) 

mv: Moves or renames files and directories. . . . mv(C) 

fsck: Checks and repairs file systems fsck(ADM) 

uniq: Reports repeated lines in a file uniq(C) 

yes: Prints string repeatedly yes(C) 

blocks, df: Report number of free disk .... df(C) 

Generate an IMAGEN accounting report, imacct: imacct(C) 

clock: Reports CPU time used clock(S) 

cmchk: Reports hard disk block size. . . . cmchk(C) 

ps: Reports process status ps(C) 

file, uniq: Reports repeated lines in a .... uniq(C) 

pstat: Reports system information. . . . pstat(C) 

inter-process/ ipcs: Reports the status of ipcs(ADM) 

vmstat: Reports virtual memory statistics. . vmstat(C) 

stream, fseek, ftell, rewind: Repositions a file pointer in a . . . fseek(S) 

Starts/stops the lineprinter request, /lpshut, lpmove: .... lpsched(ADM) 

lp, lpr, cancel: Send/cancel requests to lineprinter lp(C) 

stackuse: Determines stack requirements for C programs. . . . stackuse(CP) 

/Awaits and checks access to a resource governed by a/ waitsem(S) 

incremental file/ restore, restor: Invokes restore(C) 

Invokes incremental file system/ restore, restor: restore(C) 

Invokes incremental file system restorer, /restor: restore(C) 

Performs file system backups and restores files, sysadmin: .... sysadmin(ADM) 

interpreter), rsh: Invokes a restricted shell (command .... rsh(C) 

red: Invokes a restricted version of. red(C) 

fp_off, fp_seg: Return offset and segment fp_seg(DOS) 

stat: Data returned by stat system call. . . . stat(F) 

inp: Returns a byte inp(DOS) 

console buffer, ungetch: Returns a character to the .... ungetch(DOS) 

value, abs: Returns an integer absolute . . . abs(S) 

long integer, labs: Returns the absolute value of a . . labs(DOS) 

strlen: Returns the length of a string. . . strlen(DOS) 

value, false: Returns with a nonzero exit . . . false(C) 

true: Returns with a zero exit value. . . true(C) 
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col: Filters reverse linefeeds col(CT) 

in a string, strrev: Reverses the order of characters . strrev(DOS) 

pointer in a/ fseek, ftell, rewind: Repositions a file .... fseek(S) 

creat: Creates a new file or rewrites an existing one creat(S) 

directories, rm, rmdir: Removes files or ... rm(C) 

SCCS file, rmdel: Removes a delta from an . rmdel(CP) 

rmdir: Deletes a directory rmdir(DOS) 

rmdir: Removes directories. . . . rmdir(C) 

directories, rm, rmdir: Removes files or rm(C) 

from the system, rmuser. Removes a user account . rmuser(ADM) 

chroot: Changes the root directory chroot(S) 

chroot: Changes root directory for command. . . . chroot(ADM) 

logarithm, power, square root functions, /exponential, . . . exp(S) 

/system services, library routines and error numbers. . . . Lntro(S) 

expression compile and match routines, regexp: Regular .... regexp(S) 

(command interpreter), rsh: Invokes a restricted shell . . . rsh(C) 

priority, nice: Runs a command at a different . . nice(C) 

and quits, nohup: Runs a command immune to hangups nohup(C) 

editing activity, sact: Prints current SCCS file . . . sact(CP) 

space allocation, sbrk, brk: Changes data segment . sbrk(S) 

work, uucico: Scan the spool directory for ... uucico(C) 

and formats input, scanf, fscanf, sscanf: Converts . . scanf(S) 

bfs: Scans big files bfs(C) 

creates bad track/ badtrk: Scans fixed disk for flaws and . . badtrk(ADM) 

help: Asks for help about SCCS commands help(CP) 

the delta commentary of an SCCS delta, ede: Changes .... cdc(CP) 

comb: Combines SCCS deltas comb(CP) 

sact: Prints current SCCS file editing activity sact(CP) 

prs: Prints an SCCS file prs(CP) 

rmdel: Removes a delta from an SCCS file rmdel(CP) 

sccsfile: Format of an SCCS file sccsfile(F) 

val: Validates an SCCS file val(CP) 

Makes a delta (change) to an SCCS file, delta: delta(CP) 

admin: Creates and administers SCCS files admin(CP) 

Compares two versions of an SCCS file, sccsdiff: sccsdiff(CP) 

Undoes a previous get of an SCCS file, unget: unget(CP) 

of an SCCS file, sccsdiff: Compares two versions . sccsdiff(CP) 

file, sccsfile: Format of an SCCS . . . sccsfile(F) 

system backups schedule: Database for automated . schedule(ADM) 

transport program uusched: the scheduler for the uucp file .... uusched(ADM) 

curses: Performs screen and cursor functions. . . . curses(S) 

clear: Clears a terminal screen. . . clear(C) 

setcolor: Set screen color setcolor(C) 

convkey: Configure monitor screen mapping, /mapstr, .... mapkey(M) 

color, monochrome, ega,. screen: tty [01-«], screen(HW) 

vi, view, vedit: Invokes a screen-oriented display editor. . . vi(C) 

install: Installation shell script install(M) 

IMAGEN printer interface scripts, /imagen.remote: .... imagen(M) 

interface, scsi: Small computer systems . . . scsi(HW) 

sdb: Invokes symbolic debugger. . sdb(CP) 

dates, sddate: Prints and sets backup . . sddate(C) 
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access to a shared data/ sdenter, sdleave: Synchronizes . . sdenter(S) 

shared data segment, sdget, sdfree: Attaches and detaches a . . sdget(S) 

detaches a shared data segment, sdget, sdfree: Attaches and . . . sdget(S) 

shared data access, sdgetv, sdwaitv: Synchronizes . . sdgetv(S) 

side-by-side, sdiffi Compares files sdiff(C) 

a shared data segment, sdenter, sdleave: Synchronizes access to . sdenter(S) 

data access, sdgetv, sdwaitv: Synchronizes shared . . sdgetv(S) 

lsearch, lfind: Performs linear search and update lsearch(S) 

bsearch: Performs a binary search bsearch(S) 

hcreate, hdestroy: Manages hash search tables, hsearch, hsearch(S) 

tdelete, twalk: Manages binary search trees, tsearch, tfind, . . . tsearch(S) 

grep, egrep, fgrep: Searches a file for a pattern. . . . grep(C) 

accounting files, acctcom: Searches for and prints process . . acctcom(ADM) 

pattern in a file, awk: Searches for and processes a . . . awk(C) 

sed: Invokes the stream editor. . . sed(C) 

uniformly distributed. srand48, seed48, lcong48: Generates . . . drand48(S) 

brkctl: Allocates data in a far segment brkctl(S) 

shmget: Gets a shared memory segment shmget(S) 

sbrk, brk: Changes data segment space allocation sbrk(S) 

fp_seg: Return offset and segment. fp_off, fp_seg(DOS) 

and detaches a shared data segment, /sdfree: Attaches . . . sdget(S) 

access to a shared data segment, /sdleave: Synchronizes . sdenter(S) 

segread: command description. . . segread(DOS) 

a file, cut: Cuts out selected fields of each line of . . . cut(CT) 

binary files, hdr: Displays selected parts of executable . . . hdr(CP) 

to two sorted files, comm: Selects or rejects lines common . . comm(C) 

opensem: Opens a semaphore opensem(S) 

semctl: Controls semaphore operations semctl(S) 

semop: Performs semaphore operations semop(S) 

ipcrm: Removes a message queue, semaphore set or shared memory. . ipcrm(ADM) 

to a resource governed by a semaphore, /and checks access . . waitsem(S) 

Creates an instance of a binary semaphore, creatsem: creatsem(S) 

files, lockf: Provide semaphores and record locking on . lockf(S) 

semget: Gets set of semaphores semget(S) 

Signals a process waiting on a semaphore, sigsem: sigsem(S) 

operations, semctl: Controls semaphore . . . semctl(S) 

semget: Gets set of semaphores. . semget(S) 

fsphoto: Performs periodic semi-automated system backups . fsphoto(ADM) 

operations, semop: Performs semaphore . . . semop(S) 

hello: Send a message to another user. . . hello(ADM) 

lineprinter. lp, lpr, cancel: Send/cancel requests to lp(C) 

group of processes, kill: Sends a signal to a process or a . . kill(S) 

queue for printing, lpr: Sends files to the lineprinter . . . lpr(C) 

mail, mail: Sends, reads or disposes of ... . mail(C) 

/sys_errlist, sys_nerr, errno: Sends system error messages. . . perror(S) 

mesg: Permits or denies messages sent to a terminal mesg(C) 

handler, ips: Imagen serial sequence packet protocol .... ips(ADM) 

file to printer attached to a serial console /Print consoleprint(ADM) 

mscreen: Serial multiscreens utility .... mscreen(M) 

,tty2[A-H]: Interface to serial ports. /,tty2[a-h] serial(HW) 

handler, ips: Imagen serial sequence packet protocol . . ips(ADM) 
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calendar: Invokes a reminder service calendar(C) 

error/ intro: Introduces system services, library routines and . . . Intro(S) 

Map of the ASCII character set. ascii: ascii(M) 

buffering to a stream, setbuf, setvbuf: Assigns setbuf(S) 

real-time (time of day) clock, setclock: Sets the system .... setclock(ADM) 

setcolor: Set screen color setcolor(C) 

setuid, setgid: Sets user and group IDs. . . setuid(S) 

getgrent, getgrgid, getgrnam, setgrent, endgrent: Get group/ . . getgrent(S) 

nonlocal "goto", setjmp, longjmp: Performs a . . . setjmp(S) 

keys, setkey: Assigns the function . . . setkey(C) 

table, setmnt: Establishes /etc/rrinttab . . setmnt(ADM) 

setmode: Sets translation mode. . . setmode(DOS) 

setpgrp: Sets process group ID. . . setpgrp(S) 

getpwent, getpwuid, getpwnam, setpwent, endpwent: Gets/ .... getpwent(S) 

alarm: Sets a process' alarm clock. . . . alarm(S) 

to one charater. strset: Sets all characters in a string . . . strset(DOS) 

mask, umask: Sets and gets file creation .... umask(S) 

sddate: Prints and sets backup dates sddate(C) 

execution, env: Sets environment for command . . env(C) 

modification times, utime: Sets file access and utime(S) 

umask: Sets file-creation mode mask. . . umask(C) 

setpgrp: Sets process group ID setpgrp(S) 

tset: Sets terminal modes tset(C) 

speed, and line/ getty: Sets terminal type, modes, .... getty(M) 

base, cmos: Displays and sets the configuration data .... cmos(HW) 

date: Prints and sets the date date(C) 

a video device, vidi: Sets the font and video mode for . vidi(C) 

stty: Sets the options for a terminal. . . stty(C) 

of day) clock, setclock: Sets the system real-time (time . . setclock(ADM) 

stime: Sets the time stime(S) 

setmode: Sets translation mode setmode(DOS) 

trchan: Translate character sets trchan(M) 

time, profile: Sets up an environment at login . . profile(M) 

setuid, setgid: Sets user and group IDs setuid(S) 

ulimit: Gets and sets user limits ulimit(S) 

modification dates of files, settime: Changes the access and . settime(ADM) 

getty defs: Speed and terminal settings used by getty getty defs(F) 

group IDs. setuid, setgid: Sets user and . . . setuid(S) 

stream, setbuf, setvbuf: Assigns buffering to a . . setbuf(S) 

data in a/ sputl, sgetl: Accesses long integer . . . sputl(S) 

interpreter, sh: Invokes the shell command . . sh(C) 

sdgetv, sdwaitv: Synchronizes shared data access sdgetv(S) 

sdfree: Attaches and detaches a shared data segment, sdget, . . . sdget(S) 

Synchronizes access to a shared data segment, /sdleave: . . sdenter(S) 

shmctl: Controls shared memory operations. . . . shmctl(S) 

shmop: Performs shared memory operations. . . . shmop(S) 

shmget: Gets a shared memory segment shmget(S) 

message queue, semaphore set or shared memory, ipcrm: Removes a ipcrm(ADM) 

sopen: Opens a file for shared reading and writing. . . . sopen(DOS) 

rsh: Invokes a restricted shell (command interpreter). . . . rsh(C) 

sh: Invokes the shell command interpreter sh(C) 
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C-like syntax, csh: Invokes a shell command interpreter with . . csh(C) 

system: Executes a shell command. . * system(S) 

chsh: changes user login shell in password file chsh(ADM) 

shl: Shell layer manager shl(C) 

install: Installation shell script install(M) 

shl: Shell layer manager shl(C) 

operations, shmctl: Controls shared memory . shmctl(S) 

segment, shmget: Gets a shared memory . . shmget(S) 

operations, shmop: Performs shared memory . shmop(S) 

nap: Suspends execution for a short interval nap(S) 

halts the CPU. shutdn: Flushes block I/O and . . shutdn(S) 

processing, shutdown: Terminates all .... shutdown(ADM) 

Closes out the file systems and shuts down the system, /reboot: . haltsys(ADM) 

sdiff: Compares files side-by-side sdiff(C) 

Suspends a process until a signal occurs, pause: pause(S) 

upon receipt of a signal, signal: Specifies what to do ... signal(S) 

of processes, kill: Sends a signal to a process or a group . . . kill(S) 

semaphore, sigsem: Signals a process waiting on a . . sigsem(S) 

what to do upon receipt of a signal, signal: Specifies signal(S) 

gsignal: Implements software signals, ssignal, ssignal(S) 

waiting on a semaphore, sigsem: Signals a process .... sigsem(S) 

atan2: Performs trigonometric/ sin, cos, tan, asin, acos, atan, . . . trig(S) 

hyperbolic functions, sinh, cosh, tanh: Performs .... sinh(S) 

cmchk: Reports hard disk block size cmchk(C) 

chsize: Changes the size of a file chsize(S) 

size: Prints the size of an object file size(CP) 

object file, size: Prints the size of an .... size(CP) 

interval, sleep: Suspends execution for an . sleep(C) 

interval, sleep: Suspends execution for an . sleep(S) 

current/ ttyslot: Finds the slot in the utmp file of the .... ttyslot(S) 

spline: Interpolates smooth curve spline(CP) 

nroff input, soelim: Eliminates .so's from . . . soelim(CT) 

ssignal, gsignal: Implements software signals ssignal(S) 

reading and writing, sopen: Opens a file for shared . . sopen(DOS) 

qsort: Performs a quicker sort qsort(S) 

sort: Sorts and merges files. . . . sort(C) 

or rejects lines common to two sorted files, coram: Selects . . . comm(C) 

look: Finds lines in a sorted list look(CT) 

tsort: Sorts a file topologically tsort(CP) 

sort: Sorts and merges files sort(C) 

soelim: Eliminates .so's from nroff input soelim(CT) 

an error message file from C source, mkstr: Creates mkstr(CP) 

sbrk, brk: Changes data segment space allocation sbrk(S) 

ct: spawn getty to a remote terminal . ct(C) 

process, spawnl, spawnvp: Creates a new . spawn(DOS) 

spawnl, spawnvp: Creates a new process. . spawn(DOS) 

movedata: Copies bytes from a specific address movedata(DOS) 

cron: Executes commands at specified times cron(C) 

receipt of a signal, signal: Specifies what to do upon .... signal(S) 

/Sets terminal type, modes, speed, and line discipline getty(M) 

by getty. gettydefs: Speed and terminal settings used . gettydefs(F) 
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hashcheck: Finds spelling/ spell, hashmake, spellin, .... spell(CT) 

spelling/ spell, hashmake, spellin, hashcheck: Finds .... spell(CT) 

spellin, hashcheck: Finds spelling errors, /hashmake, . . . spell(CT) 

curve, spline: Interpolates smooth . . . spline(CP) 

pieces, split: Splits a file into split(C) 

split: Splits a file into pieces split(C) 

context, csplit: Splits files according to csplit(C) 

into a/ frexp, ldexp, modf: Splits floating-point number . . . frexp(S) 

uuclean: uucp spool directory clean-up uuclean(ADM) 

uucico: Scan the spool directory for work uucico(C) 

Configures the lineprinter spooling system, lpadmin: .... lpadmin(ADM) 

printf, fprintf, sprintf: Formats output printf(S) 

integer data in a/ sputl, sgetl: Accesses long .... sputl(S) 

exponential,/ exp, log, pow, sqrt, loglO: Performs exp(S) 

exponential, logarithm, power, square root functions. /Performs . exp(S) 

number, rand, srand: Generates a random .... rand(S) 

Generates uniformly/ srand48, seed48, lcong48: .... drand48(S) 

input, scanf, fscanf, sscanf: Converts and formats . . . scanf(S) 

software signals, ssignal, gsignal: Implements . . . ssignal(S) 

programs, stackuse: Determines stack requirements for C .... stackuse(CP) 

requirements for C programs, stackuse: Determines stack . . . stackuse(CP) 

output, stdio: Performs standard buffered input and . . . stdio(S) 

Converts Rational FORTRAN into standard FORTRAN, ratfor: . . . ratfor(CP) 

gets: Gets a string from the standard input gets(CP) 

communication package, ftok: Standard interprocess stdipc(S) 

pr: Prints files on the standard output pr(C) 

lpsched, lpshut, lpmove: Starts/stops the lineprinter/ .... lpsched(ADM) 

system call, stat: Data returned by stat .... stat(F) 

stat, fstat: Gets file status stat(S) 

stat: Data returned by stat system call stat(F) 

prep: Prepares text for statistical processing prep(CT) 

ustat: Gets file system statistics ustat(S) 

virtual memory statistics, vmstat: Reports .... vmstat(C) 

lpstat: prints lineprinter status information lpstat(C) 

uustat: uucp status inquiry and job control. . . uustat(C) 

communication/ ipcs: Reports the status of inter-process ipcs(ADM) 

ps: Reports process status ps(C) 

stat, fstat: Gets file status stat(S) 

fileno: Determines stream status, ferror, feof, clearerr, . . . ferror(S) 

buffered input and output, stdio: Performs standard stdio(S) 

stime: Sets the time stime(S) 

Waits for a child process to stop or terminate, wait: wait(S) 

compress: Compress data for storage compress(C) 

nextkey:/ dbminit, fetch, store, delete, firstkey, dbm(S) 

uncompress: Uncompress a stored file compress(C) 

zcat: Display a stored file compress(C) 

operations, strdup: Performs string string(S) 

Invokes the stream editor, sed: sed(C) 

fopen, freopen, fdopen: Opens a stream fopen(S) 

puts, fputs: Puts a string on a stream puts(S) 

clearerr, fileno: Determines stream status, ferror, feof, .... ferror(S) 
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fflush: Closes or flushes a stream, fclose, fclose(S) 

Gets a character from a stream, fgetc, fgetchar: fgetc(DOS) 

fputchar: Write a character to a stream, fputc, fputc(DOS) 

Repositions a file pointer in a stream, fseek, ftell, rewind: . . . fseek(S) 

Gets character or word from a stream, /getchar, fgetc, getw: . . getc(S) 

fgets: Gets a string from a stream, gets, gets(S) 

Prints the first few lines of a stream, head: head(C) 

Puts a character or word on a stream, /putchar, fputc, putw: . . putc(S) 

fclose, fcloseall: Closes streams fclose(DOS) 

setvbuf: Assigns buffering to a stream, setbuf, setbuf(S) 

Pushes character back into input stream, ungetc: ungetc(S) 

cgets: Gets a string cgets(DOS) 

gets, fgets: Gets a string from a stream gets(S) 

gets: Gets a string from the standard input. . . gets(CP) 

puts, fputs: Puts a string on a stream puts(S) 

strdup: Performs string operations string(S) 

yes: Prints string repeatedly yes(C) 

strlen: Returns the length of a string strlen(DOS) 

strtod, atof: Converts a string to a double-precision/ . . . strtod(S) 

strtol, atol, atoi: Converts string to integer strtol(S) 

strset: Sets all characters in a string to one charater strset(DOS) 

cputs: Puts a string to the console. ....... cputs(DOS) 

strings in an object file, strings: Finds the printable .... strings(CP) 

xstr: Extracts strings from C programs xstr(CP) 

strings: Finds the printable strings in an object file strings(CP) 

the order of characters in a string, strrev: Reverses strrev(DOS) 

relocation bits, strip: Removes symbols and . . . strip(CP) 

string, strlen: Returns the length of a . . strlen(DOS) 

characters to lowercase, strlwr: Converts uppercase .... strlwr(DOS) 

characters in a string, strrev: Reverses the order of ... strrev(DOS) 

string to one charater. strset: Sets all characters in a ... strset(DOS) 

to a double-precision number, strtod, atof: Converts a string . . . strtod(S) 

string to integer, strtol, atol, atoi: Converts .... strtol(S) 

mount: Mounts a file structure mount(ADM) 

umount: Dismounts a file structure umount(ADM) 

characters to uppercase, strupr: Converts lowercase .... strupr(DOS) 

terminal, stty: Sets the options for a .... stty(C) 

of a document, style: Analyzes characteristics . . style(CT) 

or another user, su: Makes the user a super-user . . su(C) 

counts blocks in a file, sum: Calculates checksum and . . sum(C) 

du: Summarizes disk usage du(C) 

ownership, quot: Summarizes file system quot(C) 

sync: Updates the super-block sync(ADM) 

sync: Updates the super-block sync(S) 

su: Makes the user a super-user or another user su(C) 

terminals: List of supported terminals terminals(M) 

keyboard mode or test keyboard support kbmode: Set kbmode(ADM) ( 

signal occurs, pause: Suspends a process until a .... pause(S) 

interval, nap: Suspends execution for a short . . nap(S) 

interval, sleep: Suspends execution for an .... sleep(C) 

interval, sleep: Suspends execution for an .... sleep(S) 
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swab: Swaps bytes swab(S) 

swapadd: Adds swap area swapadd(S) 

swapadd: Adds swap area .... swapadd(S) 

swab: Swaps bytes swab(S) 

fdswap: Swaps default boot floppy drive. . fdswap(ADM) 

sxt: Pseudo-device driver sxt(M) 

sdb: Invokes symbolic debugger sdb(CP) 

strip: Removes symbols and relocation bits. . . . strip(CP) 

sync: Updates the super-block. . . sync(ADM) 

sync: Updates the super-block. . . sync(S) 

data segment, sdenter, sdleave: Synchronizes access to a shared . sdenter(S) 

sdgetv, sdwaitv: Synchronizes shared data access. . sdgetv(S) 

command interpreter with C-like syntax, csh: Invokes a shell . . . csh(C) 

Checks C language usage and syntax, lint: lint(CP) 

backups and restores files, sysadmin: Performs file system . . sysadmin(ADM) 

administration utility, sysadmsh: Menu driven system . . sysadmsh(ADM) 

Sends system error/ perror, sys_errlist, sys_nerr, errno: . . . perror(S) 

error/ perror, sys_errlist, sys_nerr, errno: Sends system . . perror(S) 

config: Configures a XENIX system config(ADM) 

cu: Calls another XENIX system cu(C) 

mkfs: Constructs a file system mkfs(ADM) 

mkuser: Adds a login ID to the system mkuser(ADM) 

mount: Mounts a file system mount(S) 

umount: Unmounts a file system umount(S) 

who: Lists who is on the system who(C) 

Automatically boots the system, autoboot: autoboot(ADM) 

identification file, systemid: The Micnet system . . . systemid(F) 

the lineprinter spooling system, lpadmin: Configures . . . lpadmin(ADM) 

file systems and shuts down the system, /reboot: Closes out the . . haltsys(ADM) 

commands on a remote XENIX system, remote: Executes .... remote(C) 

Removes a user account from the system, rmuser: rmuser(ADM) 

/reboot: Closes out the file systems and shuts down the/ . . . haltsys(ADM) 

fsck: Checks and repairs file systems fsck(ADM) 

scsi: Small computer systems interface scsi(HW) 

checklist: List of file systems processed by fsck checklist(F) 

rep: Copies files across XENIX systems rcp(C) 

the name of the current XENIX system, uname: Prints uname(C) 

Gets name of current XENIX system, uname: uname(S) 

device, systty: System maintenance . . . systty(M) 

aliashash: Micnet alias hash table generator aliashash(ADM) 

setmnt: Establishes /etc/mnttab table setmnt(ADM) 

for flaws and creates bad track table, badtrk: Scans fixed disk . . badtrk(ADM) 

Master device information table, master: master(F) 

Format of mounted file system table, mnttab: mnttab(F) 

tbl: Formats tables for nroff or troff. tbl(CT) 

term: Terminal driving tables for nroff. term(F) 

hdestroy: Manages hash search tables, hsearch, hcreate, .... hsearch(S) 

ctags: Creates a tags file ctags(CP) 

a file, tail: Delivers the last part of ... tail(C) 

Performs/ sin, cos, tan, asin, acos, atan, atan2: .... trig(S) 

functions, sinh, cosh, tanh: Performs hyperbolic .... sinh(S) 
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backup: Incremental dump tape format backup(F) 

dump: Incremental dump tape format dump(F) 

program, tape: Magnetic tape maintenance . tape(C) 

tape: Magnetic tape maintenance program. . . . tape(C) 

tapedump: Dumps magnetic tape to output file tapedump(C) 

output file, tapedump: Dumps magnetic tape to tapedump(C) 

tar: archive format tar(F) 

tar: Archives files tar(C) 

deroff: Removes nroff/troff, tbl, and eqn constructs deroff(CT) 

troff. tbl: Formats tables for nroff or . . tbl(CT) 

search trees, tsearch, tfind, tdelete, twalk: Manages binary . . tsearch(S) 

tee: Creates a tee in a pipe. . . . tee(C) 

tee: Creates a tee in a pipe tee(C) 

last logins of users and teletypes last: Indicate last(C) 

method of turning terminals on/ telinit, mkinittab: Alternative . . . telinit(ADM) 

temporary file, tmpnam, tempnam: Creates a name for a . . tmpnam(S) 

tmpfile: Creates a temporary file tmpfile(S) 

tempnam: Creates a name for a temporary file, tmpnam, .... tmpnam(S) 

term: Conventional names. . . . term(CT) 

for nroff. term: Terminal driving tables . . . term(F) 

terminfo/ capinfo: convert termcap descriptions into .... capinfo(C) 

data base, termcap: Terminal capability . . . termcap(M) 

termcap: Terminal capability data base. . . termcap(M) 

terminfo: terminal capability data base. . . . terminfo(M) 

ct: spawn getty to a remote terminal ct(C) 

terminfo: terminal description database. . . terminfo(S) 

nroff. term: Terminal driving tables for ... . term(F) 

tgetstr, tgoto, tputs: Performs terminal functions, /tgetflag, . . . termcap(S) 

termio: General terminal interface termio(M) 

tty: Special terminal interface tty(M) 

dial: Establishes an out-going terminal line connection dial(S) 

lock: Locks a user's terminal lock(C) 

terminal: Login terminal terminal(HW) 

tset: Sets terminal modes tset(C) 

clear: Clears a terminal screen clear(C) 

getty defs: Speed and terminal settings used by getty. . . gettydefs(F) 

stty: Sets the options for a terminal stty(C) 

terminal: Login terminal terminal(HW) 

line discipline, getty: Sets terminal type, modes, speed, and . getty(M) 

Generates a filename for a terminal, ctermid: ctermid(S) 

a printer attached to the user's terminal lprint: Print to lprint(C) 

or denies messages sent to a terminal, mesg: Permits mesg(C) 

enable: Turns on terminals and line printers enable(C) 

disable: Turns off terminals and printers disable(C) 

inittab: Alternative login terminals file. inittab(F) 

ttys: Login terminals file ttys(F) 

terminals, terminals: List of supported . . . terminals(M) 

tty: Gets the terminal's name tty(C) 

/Alternative method of turning terminals on and off. telinit(ADM) 

terminals: List of supported terminals terminals(M) 

isatty: Finds the name of a terminal, ttyname, ttyname(S) 
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exit, _exit: Terminates a process exit(S) 

kill: Terminates a process kill(C) 

shutdown: Terminates all processing shutdown(ADM) 

exit: Terminates the calling process. . . exit(DOS) 

for a child process to stop or terminate, wait: Waits wait(S) 

tic: Terminfo compiler tic(C) 

tput: Queries the terminfo database tput(C) 

termcap descriptions into terminfo descriptions, /convert . . capinfo(C) 

terminfo: Format of compiled terminfo file terminfo(F) 

terminfo file, terminfo: Format of compiled . . terminfo(F) 

data base, terminfo: terminal capability . . . terminfo(M) 

database, terminfo: terminal description . . terminfo(S) 

interface, termio: General terminal .... termio(M) 

kbmode: Set keyboard mode or test keyboard support kbmode(ADM) 

test: Tests conditions test(C) 

test: Tests conditions test(C) 

ed: Invokes the text editor ed(C) 

ex: Invokes a text editor ex(C) 

newform: Changes the format of a text file newform(C) 

diff: Compares two text files diff(C) 

imprint: Prints text files on an IMAGEN printer. . imprint(C) 

imprint: print text files on an IMAGEN printer. . imprint(CT) 

iprint: Converts text files to DVI format iprint(C) 

eqncheck: Formats mathematical text for nroff, troff. /checkeq, . . . eqn(CT) 

prep: Prepares text for statistical processing. . . . prep(CT) 

cwcheck: Prepares constant-width text for troff. cw, checkcw, . . . cw(CT) 

nroff: A text formatter nroff(CT) 

plock: Lock process, text, or data in memory plock(S) 

intro: Introduces text processing commands. . . . Intro(CT) 

troff: Typesets text troff(CT) 

binary search trees, tsearch, tfind, tdelete, twalk: Manages . . tsearch(S) 

tgetstr, tgoto, tputs: Performs/ tgetent, tgetnum, tgetflag, .... termcap(S) 

Performs/ tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: . . . termcap(S) 

tgoto, tputs: Performs/ tgetent, tgetnum, tgetflag, tgetstr, .... termcap(S) 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: Performs/ . . termcap(S) 

/tgetnum, tgetflag, tgetstr, tgoto, tputs: Performs terminal/ . . termcap(S) 

tic: Terminfo compiler tic(C) 

time, ftime: Gets time and date. . . time(S) 

clock: The system real-time (time of day) clock clock(F) 

Sets the system real-time (time of day) clock, setclock: . . setclock(ADM) 

stime: Sets the time stime(S) 

Executes commands at a later time, at, batch: at(C) 

Sets up an environment at login time, profile: profile(M) 

Executes commands at specified times, cron: cron(C) 

Gets process and child process times, times: times(S) 

file access and modification times, utime: Sets utime(S) 

file, tmpfile: Creates a temporary . . . tmpfile(S) 

for a temporary file, tmpnam, tempnam: Creates a name tmpnam(S) 

/isascii, tolower, toupper, toascii: Classifies or converts/ . . ctype(S) 

conv, toupper, tolower, toascii: Translates characters. . . conv(S) 

characters, conv, toupper, tolower, toascii: Translates .... conv(S) 
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/isgraph, iscntrl, isascii, tolower, toupper, toascii:/ .... ctype(S) 

topology files, top, top.next: The Micnet .... top(F) 

files, top, top.next: The Micnet topology . . top(F) 

tsort: Sorts a file topologically tsort(CP) 

top, top.next: The Micnet topology files top(F) 

modification times of a file, touch: Updates access and .... touch(C) 

/iscntrl, isascii, tolower, toupper, toascii: Classifies or/ . . ctype(S) 

Translates characters, conv, toupper, tolower, toascii: .... conv(S) 

database, tput: Queries the terminfo .... tput(C) 

/tgetflag, tgetstr, tgoto, tputs: Performs terminal/ .... termcap(S) 

tr: Translates characters tr(C) 

ptrace: Traces a process ptrace(S) 

disk for flaws and creates bad track table. /Scans fixed .... badtrk(ADM) 

trchan: Translate character sets trchan(M) 

one format to another translate: Translates files from . . translate(C) 

conv, toupper, tolower, toascii: Translates characters conv(S) 

tr: Translates characters tr(C) 

to another translate: Translates files from one format . . translate(C) 

setmode: Sets translation mode setmode(DOS) 

decode a binary file for transmission via mail uudecode: . uuencode(C) 

encode a binary file for transmission via mail uuencode: . uuencode(C) 

the scheduler for the uucp file transport program uusched: . . . uusched(ADM) 

trchan: Translate character sets . . trchan(M) 

ftw: Walks a file tree ftw(S) 

twalk: Manages binary search trees, tsearch, tfind, tdelete, . . . tsearch(S) 

acos, atan, atan2: Performs trigonometric functions, /asin, . . trig(S) 

tbl: Formats tables for nroff or troff. tbl(CT) 

itroff: Troff to an IMAGEN printer. . . . itroff(CT) 

troff: Typesets text troff(CT) 

file, charmap: Generate troff width files and catab .... charmap(CT) 

Prepares constant-width text for troff. cw, checkcw, cwcheck: . . cw(CT) 

mathematical text for nroff, troff. /eqncheck: Formats .... eqn(CT) 

with debugging on uutry: try to contact remote system . . . uutry(ADM) 

Manages binary search trees, tsearch, tfind, tdelete, twalk: . . . tsearch(S) 

tset: Sets terminal modes tset(C) 

topologically. tsort: Sorts a file tsort(CP) 

mapchan: Format of tty device mapping files mapchan(F) 

mapchan: Configure tty device mapping mapchan(M) 

tty: Gets the terminal's name. . . tty(C) 

tty: Special terminal interface. . . tty(M) 

monochrome, ega,. screen: tty [01 -n], color, screen(HW) 

tty2[a-h] ,tty2[A-H]:/ ttyl[a-h] , ttyl[A-H] , serial(HW) 

tty2[A-HJ: Interface/ tty l[a-h] ttyl[A-H] , tty2[a-h] , serial(HW) 

tty2[A-H]:/ ttyl[a-h] , ttyl[A-H] , tty2[a-h] , serial(HW) 

to/ ttyl[a-h] ,ttyl[A-H] , tty2[a-h] , tty 2 [A-H]: Interface . . serial(HW) 

Interface/ ttyl[a-h] ,ttyl[A-H] tty2[a-h] , tty2[A-H]: serial(HW) 

/,ttyl[A-H] ,tty2[a-h] , tty2[A-H]: Interface to serial/ . . serial(HW) 

ports. /, tty 1 [A-H] ,tty2[a-h] tty2 [A-H]: Interface to serial . . . serial(HW) 

of a terminal, ttyname, isatty: Finds the name . . ttyname(S) 

ttys: Login terminals file ttys(F) 

utmp file of the current user, ttyslot: Finds the slot in the ... ttyslot(S) 
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/mkinittab: Alternative method of turning terminals on and off. ... telinit(ADM) 

printers, disable: Turns off terminals and disable(C) 

accton: Turns on accounting accton(ADM) 

printers, enable: Turns on terminals and line . . . enable(C) 

trees, tsearch, tfind, tdelete, twalk: Manages binary search . . tsearch(S) 

dtype: Determines disk type dtype(C) 

file: Determines file type file(C) 

getty: Sets terminal type, modes, speed, and line/ . . . getty(M) 

types, types: Primitive system data . . . types(F) 

types: Primitive system data types types(F) 

mmt: Typesets documents mmt(CT) 

troff: Typesets text trofflCT) 

variable. TZ: Time zone environment . . . tz(M) 

/localtime, gmtime, asctime, tzset: Converts date and time to/ . ctime(S) 

uadmin: administrative control. . . uadmin(S) 

limits, ulimit: Gets and sets user .... ulimit(S) 

characters, ultoa: Converts numbers to ... ultoa(DOS) 

creation mask, umask: Sets and gets file .... umask(S) 

mask, umask: Sets file-creation mode . . umask(C) 

structure, umount: Dismounts a file .... umount(ADM) 

umount: Unmounts a file system. . umount(S) 

XENIX system, uname: Gets name of current . . . uname(S) 

current XENIX system, uname: Prints the name of the . . uname(C) 

uncompress: Uncompress a stored file compress(C) 

file, uncompress: Uncompress a stored . compress(C) 

file, unget: Undoes a previous get of an SCCS unget(CP) 

an SCCS file, unget: Undoes a previous get of . . unget(CP) 

into input stream, ungetc: Pushes character back . . ungetc(S) 

the console buffer, ungetch: Returns a character to . . ungetch(DOS) 

seed48, lcong48: Generates uniformly distributed. srand48, . . drand48(S) 

a file, uniq: Reports repeated lines in . . uniq(C) 

mktemp: Makes a unique filename mktemp(S) 

units: Converts units units(C) 

units: Converts units units(C) 

unlink: Removes directory entry. . unlink(S) 

reading or/ locking: Locks or unlocks a file region for locking(S) 

umount: Unmounts a file system umount(S) 

files, pack, peat, unpack: Compresses and expands . pack(C) 

Performs linear search and update, lsearch, lfind: lsearch(S) 

times of a file, touch: Updates access and modification . touch(C) 

of programs, make: Maintains, updates, and regenerates groups . make(CP) 

sync: Updates the super-block sync(ADM) 

sync: Updates the super-block sync(S) 

lowercase, strlwr: Converts uppercase characters to strlwr(DOS) 

Converts lowercase characters to uppercase, strupr: strupr(DOS) 

about system activity, uptime: Displays information . . . uptime(C) 

lint: Checks C language usage and syntax lint(CP) 

diction: Checks language usage diction(CT) 

du: Summarizes disk usage du(C) 

explain: Corrects language usage explain(CT) 

checkmm, mmcheck: Checks usage of MM macros checkmm(CT) 
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clock: Reports CPU time used clock(S) 

keystrokes usemouse: Maps mouse input to . usemouse(C) 

user, su: Makes the user a super-user or another . . . su(C) 

rmuser: Removes a user account from the system. . . rmuser(ADM) 

id: Prints user and group IDs and names. . . id(C) 

setuid, setgid: Sets user and group IDs setuid(S) 

/getgid, getegid: Gets real user, effective user, real/ getuid(S) 

environ: The user environment environ(M) 

hello: Send a message to another user hello(ADM) 

getpw: Gets password for a given user ID getpw(S) 

newgrp: Logs user into a new group newgrp(C) 

ulimit: Gets and sets user limits ulimit(S) 

file, chsh: changes user login shell in password . . . chsh(ADM) 

logname: Finds login name of user logname(S) 

group/ /Gets real user, effective user, real group, and effective . . getuid(S) 

write: Writes to another user write(C) 

Gets the login name of the user, cuserid: cuserid(S) 

last: Indicate last logins of users and teletypes last(C) 

finger: Finds information about users finger(C) 

idleout: Logs out idle users idleout(ADM) 

lock: Locks a user's terminal lock(C) 

to a printer attached to the user's terminal lprint: Print . . . lprint(C) 

wall: Writes to all users wall(ADM) 

the user a super-user or another user, su: Makes su(C) 

in the utmp file of the current user, ttyslot: Finds the slot . . . ttyslot(S) 

statistics, ustat: Gets file system ustat(S) 

mscreen: Serial multiscreens utility mscreen(M) 

driven system administration utility, sysadmsh: Menu .... sysadmsh(ADM) 

modification times, utime: Sets file access and .... utime(S) 

utmp, wtmp: Formats of utmp and wtmp entries utmp(F) 

endutent, utmpname: Accesses utmp file entry getut(S) 

ttyslot: Finds the slot in the utmp file of the current user. . . . ttyslot(S) 

wtmp entries, utmp, wtmp: Formats of utmp and . utmp(F) 

entry, endutent, utmpname: Accesses utmp file . . getut(S) 

uuchat: dials a modem dial(ADM) 

directories and permissions/ uucheck: check the uucp .... uucheck(ADM) 

for work, uucico: Scan the spool directory . uucico(C) 

clean-up uuclean: uucp spool directory . . uuclean(ADM) 

Administers UUCP control files, uuinstall: . . uuinstall(ADM) 

file uucheck: check the uucp directories and permissions . uucheck(ADM) 

uusched: the scheduler for the uucp file transport program . . . uusched(ADM) 

uusub: Monitor uucp network uusub(C) 

uuclean: uucp spool directory clean-up . . uuclean(ADM) 

control, uustat: uucp status inquiry and job . . . uustat(C) 

for transmission via mail uudecode: decode a binary file . . uuencode(C) 

for transmission via mail uuencode: encode a binary file . . uuencode(C) 

files, uuinstall: Administers UUCP control uuinstall(ADM) ( 

file copy, uuto, uupick: Public XENIX-to-XENIX . uuto(C) 

uucp file transport program uusched: the scheduler for the . . uusched(ADM) 

job control, uustat: uucp status inquiry and . . uustat(C) 

uusub: Monitor uucp network. . . uusub(C) 
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XENIX-to-XENIX file copy, uuto, uupick: Public uuto(C) 

system with debugging on uutry: try to contact remote . . . uutry(ADM) 

XENIX, uux: Executes command on remote uux(C) 

val: Validates an SCCS file. . . . val(CP) 

val: Validates an SCCS file val(CP) 

assert: Helps verify validity of program assert(S) 

abs: Returns an integer absolute value abs(S) 

ceil, fmod: Performs absolute value, floor, ceiling and/ /fabs, . . floor(S) 

getenv: Gets value for environment name. . . . getenv(S) 

labs: Returns the absolute value of a long integer labs(DOS) 

putenv: Changes or adds value to environment putenv(S) 

true: Returns with a zero exit value true(C) 

Returns with a nonzero exit value, false: false(C) 

varargs: variable argument list. . . varargs(S) 

varargs: variable argument list varargs(S) 

TZ: Time zone environment variable tz(M) 

Gets option letter from argument vector, getopt: getopt(S) 

display editor, vi, view, vedit: Invokes a screen-oriented . vi(C) 

assert: Helps verify validity of program assert(S) 

red: Invokes a restricted version of. red(C) 

sccsdiff. Compares two versions of an SCCS file sccsdiff(CP) 

formatted output of a/ vprintf, vfprintf, vsprintf: Prints vprintf(S) 

screen-oriented display editor, vi, view, vedit: Invokes a .... vi(C) 

a binary file for transmission via mail uudecode: decode . . . uuencode(C) 

a binary file for transmission via mail uuencode: encode . . . uuencode(C) 

the font and video mode for a video device, vidi: Sets vidi(C) 

vidi: Sets the font and video mode for a video device. . . vidi(C) 

mode for a video device, vidi: Sets the font and video . . . vidi(C) 

screen-oriented display/ vi, view, vedit: Invokes a vi(C) 

vmstat. Reports virtual memory statistics vmstat(C) 

statistics, vmstat: Reports virtual memory . . vmstat(C) 

file system: Format of a system volume filesystem(F) 

Prints formatted output of a/ vprintf, vfprintf, vsprintf: .... vprintf(S) 

output of a/ vprintf, vfprintf, vsprintf: Prints formatted .... vprintf(S) 

who is on the system and what w: Displays information about . . w(C) 

background processes, wait: Awaits completion of ... wait(C) 

to stop or terminate, wait: Waits for a child process . . wait(S) 

sigsem: Signals a process waiting on a semaphore sigsem(S) 

stop or terminate, wait: Waits for a child process to ... wait(S) 

checks access to a resource/ waitsem, nbwaitsem: Awaits and . waitsem(S) 

ftw: Walks a file tree ftw(S) 

wall: Writes to all users wall(ADM) 

characters, wc: Counts lines, words and . . . wc(C) 

whodo: Determines who is doing what whodo(C) 

what, whodo: Determines who is doing . whodo(C) 

charmap: Generate troff width files and catab file charmap(CT) 

hyphen: Finds hyphenated words hyphen(CT) 

cd: Changes working directory cd(C) 

chdir: Changes the working directory chdir(S) 

pwd: Prints working directory name pwd(C) 

Get the pathname of current working directory, getcwd: . . . getcwd(S) 
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Scan the spool directory for work, uucico: uucico(C) 

fputc, fputchar: Write a character to a stream. . . . fputc(DOS) 

write: Writes to a file write(S) 

write: Writes to another user. . . . write(C) 

outp: Writes a byte to an output port. . . outp(DOS) 

console, putch: Writes a character to the putch(DOS) 

putpwent: Writes a password file entry. . . . putpwent(S) 

write: Writes to a file write(S) 

wall: Writes to all users wall(ADM) 

write: Writes to another user write(C) 

open: Opens file for reading or writing open(S) 

a file region for reading or writing. /Locks or unlocks .... locking(S) 

a file for shared reading and writing, sopen: Opens sopen(DOS) 

utmp, wtmp: Formats of utmp and wtmp entries utmp(F) 

entries, utmp, wtmp: Formats of utmp and wtmp . utmp(F) 

commands, xargs: Constructs and executes . . xargs(C) 

Assembler, asx: XENIX 8086/186/286/386 .... asx(CP) 

masm: Invokes the XENIX assembler masm(CP) 

boot: XENIX boot program boot(HW) 

intro: Introduces XENIX commands Intro(C) 

commands, intro: Introduces XENIX Development System . . Intro(CP) 

Convert 386 COFF files to XENIX format, coffconv: .... coffconv(M) 

netutil: Administers the XENIX network netutil(ADM) 

config: Configures a XENIX system config(ADM) 

cu: Calls another XENIX system cu(C) 

uname: Gets name of current XENIX system. uname(S) 

Executes commands on a remote XENIX system, remote: .... remote(C) 

rep: Copies files across XENIX systems rcp(C) 

Prints the name of the current XENIX system, uname: uname(C) 

dosld: XENIX to MS-DOS cross linker. . dosld(CP) 

uux: Executes command on remote XENIX uux(C) 

uuto, uupick: Public XENIX-to-XENIX file copy. . . . uuto(C) 

entries from files, xlist, fxlist: Gets name list .... xlist(S) 

programs, xref: Cross-references C xref(CP) 

programs, xstr: Extracts strings from C ... xstr(CP) 

functions, bessel, jO, jl, jn, yO, yl, yn: Performs Bessel . . . bessel(S) 

bessel, jO, j 1 , jn, yO, y 1 , yn: Performs Bessel/ bessel(S) 

compiler-compiler, yacc: Invokes a yacc(CP) 

yes: Prints string repeatedly. . . . yes(C) 

bessel, jO, j 1 , jn, yO, y 1 , yn: Performs Bessel functions. . . bessel(S) 

zcat: Display a stored file compress(C) 

true: Returns with a zero exit value true(C) 

TZ:Time zone environment variable. . . . tz(M) 
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